Loading...
Loading...
USE FOR getting AI-generated POI text descriptions. Requires POI IDs obtained from web-search (with result_filter=locations). Returns markdown descriptions grounded in web search context. Max 20 IDs per request.
npx skill4agent add brave/brave-search-skills local-descriptionsRequires API Key: Get one at https://api.search.brave.comPlan: Included in the Search plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribeTwo-step flow: This endpoint requires POI IDs from a prior web search.
- Call
withweb-searchto get POI IDs fromresult_filter=locationslocations.results[].id- Pass those IDs to this endpoint to get AI-generated descriptions
curl -s "https://api.search.brave.com/res/v1/local/descriptions?ids=loc4CQWMJWLD4VBEBZ62XQLJTGK6YCJEEJDNAAAAAAA%3D" \
-H "Accept: application/json" \
-H "Accept-Encoding: gzip" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"curl -s "https://api.search.brave.com/res/v1/local/descriptions" \
-H "Accept: application/json" \
-H "Accept-Encoding: gzip" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
-G \
--data-urlencode "ids=loc4CQWMJWLD4VBEBZ62XQLJTGK6YCJEEJDNAAAAAAA=" \
--data-urlencode "ids=loc4HTAVTJKP4RBEBZCEMBI3NG26YD4II4PATIHPDYI="locations.results[].idweb-searchresult_filter=locationsGET https://api.search.brave.com/res/v1/local/descriptionsX-Subscription-Token: <API_KEY>| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| string[] | Yes | — | POI IDs from web search |
| Field | Type | Description |
|---|---|---|
| string | Always |
| array | List of description objects (entries may be |
| string | Always |
| string | POI identifier matching the request |
| string? | AI-generated markdown description, or |
{
"type": "local_descriptions",
"results": [
{
"type": "local_description",
"id": "loc4CQWMJWLD4VBEBZ62XQLJTGK6YCJEEJDNAAAAAAA=",
"description": "### Overview\nA cozy neighborhood cafe known for its **artisanal coffee**..."
}
]
}web-searchresult_filter=locations# 1. Search for local businesses
curl -s "https://api.search.brave.com/res/v1/web/search?q=restaurants+san+francisco&result_filter=locations" \
-H "Accept: application/json" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"
# 2. Extract POI IDs from locations.results[].id
# 3. Use those IDs with local/pois and local/descriptionslocal-pois###descriptionnull