Technical & DevelopmentIntermediate
local-pois
Fetch detailed metadata for local businesses.
Developer Setup
Setup & Installation
bash
npx skills add https://github.com/brave/brave-search-skills --skill local-poisnpx skills add https://github.com/brave/brave-search-skills --skill local-poisOr paste this URL into your assistant to install:
Overview
What This Skill Does
Retrieves business metadata, reviews, ratings, contact details, and open hours for Points of Interest (POIs).
Application
When to use this Skill
- When you need detailed metadata (hours, rating, phone, price level, website) for a local business.
- When you have location coordinates or a POI ID and need to display business details on a card.
- When you are building store locators, local directories, or city guide features in an app.
- When you need to verify business addresses and contact details against a database of 200M+ POIs.
- When you want to display aggregate rating scores and reviews for restaurants, hotels, or services.
Documentation
Show Skills.md file
Local POIs (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 full business details
Quick Start (cURL)
Get POI Details
curl -s "https://api.search.brave.com/res/v1/local/pois" \
-H "Accept: application/json" \
-H "Accept-Encoding: gzip" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
-G \
--data-urlencode "ids=loc4CQWMJWLD4VBEBZ62XQLJTGK6YCJEEJDNAAAAAAA="
Multiple POIs with Location Headers
curl -s "https://api.search.brave.com/res/v1/local/pois" \
-H "Accept: application/json" \
-H "Accept-Encoding: gzip" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
-H "X-Loc-Lat: 37.7749" \
-H "X-Loc-Long: -122.4194" \
-G \
--data-urlencode "ids=loc4CQWMJWLD4VBEBZ62XQLJTGK6YCJEEJDNAAAAAAA=" \
--data-urlencode "ids=loc4HTAVTJKP4RBEBZCEMBI3NG26YD4II4PATIHPDYI=" \
--data-urlencode "units=imperial"
Lines 1 - 36 of 184
Recommendations