Technical & DevelopmentAdvanced
local-descriptions
AI-generated descriptions of businesses and POIs.
Developer Setup
Setup & Installation
bash
npx skills add https://github.com/brave/brave-search-skills --skill local-descriptionsnpx skills add https://github.com/brave/brave-search-skills --skill local-descriptionsOr paste this URL into your assistant to install:
Overview
What This Skill Does
Generates synthesized, AI-powered rich text descriptions for Points of Interest (POIs) based on web search context.
Application
When to use this Skill
- When you need AI-generated, rich text descriptions of specific local places or businesses.
- When you want to present summaries of user reviews and highlights for a Point of Interest (POI).
- When you have obtained POI IDs from a prior location search and want to fetch descriptive markdown.
- When you want to show grounded local information in user travel guides, directories, or maps.
- When you need to batch-request descriptions for up to 20 local businesses in a single API call.
Documentation
Show Skills.md file
Local Descriptions (Search API)
Requires API Key: Get one at https://api.search.brave.com
Plan: Included in the Search plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe
Two-step flow: This endpoint requires POI IDs from a prior web search.
- Call
web-searchwithresult_filter=locationsto get POI IDs fromlocations.results[].id- Pass those IDs to this endpoint to get AI-generated descriptions
Quick Start (cURL)
Get POI Description
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}"
Multiple POIs
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="
Lines 1 - 31 of 102
Recommendations