Local Pois

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

1. Get POI IDs from local-place-search, or from web-search with result_filter=locations (locations.results[].id)
2. 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"

Note: POI IDs are opaque strings returned in web search locations.results[].id. IDs are ephemeral and expire after ~8 hours. The example IDs above are for illustration — fetch fresh IDs via web-search with result_filter=locations. Use --data-urlencode since IDs may contain =.

Endpoint

GET https://api.search.brave.com/res/v1/local/pois

Authentication: X-Subscription-Token: <API_KEY> header

Parameters

Location Headers (Optional)

For distance calculation from user location:

Response Fields

The response has type: "local_pois" and a results array of LocationResult objects:

Example Response

{  "type": "local_pois",  "results": [    {      "type": "location_result",      "title": "Park Mediterranean Grill",      "url": "https://yelp.com/biz/park-mediterranean-grill-sf",      "provider_url": "https://yelp.com/biz/park-mediterranean-grill-sf",      "id": "loc4CQWMJWLD4VBEBZ62XQLJTGK6YCJEEJDNAAAAAAA=",      "postal_address": {        "type": "PostalAddress",        "displayAddress": "123 Main St, San Francisco, CA 94102",        "streetAddress": "123 Main St",        "addressLocality": "San Francisco",        "addressRegion": "CA",        "postalCode": "94102",        "country": "US"      },      "contact": { "telephone": "+1 415-555-0123" },      "thumbnail": {        "src": "https://example.com/thumb.jpg",        "original": "https://example.com/original.jpg"      },      "rating": {        "ratingValue": 4.5,        "bestRating": 5.0,        "reviewCount": 234,      },      "opening_hours": {        "current_day": [          { "abbr_name": "Mon", "full_name": "Monday", "opens": "07:00", "closes": "21:00" }        ]      },      "coordinates": [37.7749, -122.4194],      "distance": { "value": 0.3, "units": "miles" },      "categories": ["Mediterranean", "Greek"],      "price_range": "$$",      "serves_cuisine": ["Mediterranean", "Greek"],      "timezone": "America/Los_Angeles"    }  ]}

Getting POI IDs

local-place-search returns POI IDs directly. They also come from the Web Search API (web-search) with result_filter=locations:

# 1. Search for local businessescurl -s "https://api.search.brave.com/res/v1/web/search?q=coffee+shops+near+me&result_filter=locations" \  -H "Accept: application/json" \  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \  -H "X-Loc-Lat: 37.7749" \  -H "X-Loc-Long: -122.4194"
# 2. Extract POI IDs from locations.results[].id# 3. Use those IDs with this endpoint

Use Cases

• Local business lookup: Retrieve full details (hours, contact, address) for POIs surfaced in web search
• Restaurant discovery pipeline: Search for restaurants, fetch POI details, filter by cuisine/rating/price_range
• Business hours checker: Get opening_hours for a business to determine if currently open
• Location-aware application: Combine with location headers to get distance calculations for nearby POIs

Notes

• ID format: Opaque strings (use --data-urlencode for cURL)
• Units: metric or imperial for distance measurement preference
• Max IDs: Up to 20 IDs per request