Local Descriptions

This is a two-step workflow for getting AI-generated markdown descriptions of local businesses and POIs. You first run a web search with result_filter=locations to grab POI IDs, then feed those IDs here to get 200-400 word travel-guide style summaries. The IDs expire after about 8 hours, so you can't cache them long term. It's designed to pair with the local-pois endpoint when you need both structured data (hours, ratings) and narrative context about what makes a place worth visiting. The descriptions can be null if unavailable, and you're capped at 20 IDs per request. Solid if you're building anything that needs richer local business context beyond star ratings and addresses.

skills.sh installs: 1.2K
GitHub stars: 196
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add brave/brave-search-skills --skill local-descriptions --agent claude-code

Installs into .claude/skills of the current project.

Files

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 search.

Get POI IDs from local-place-search, or from web-search with result_filter=locations (locations.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="

SKILL.md on GitHub