local-pois
USE FOR getting local business/POI details. Requires POI IDs from local-place-search, or from web-search with result_filter=locations. Returns full business information including ratings, hours, contact info. Max 20 IDs.
By brave · 928 installs
npx skills add brave/brave-search-skills --skill local-pois
Source repository · Upstream listing
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
Multiple POIs with Location Headers
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
Authentication : X Subscription Token: <API KEY header
Parameters
Parameter Type Required Default Description
ids string[] Yes — POI IDs from web search results (1 20)
search lang string No en Language preference (2+ char language code)
ui lang string No en US UI language (locale code, e.g., "en US")
units string No null metric (km) or imperial (miles)
Location Headers (Optional)
For distance calculation from user location:
Header Type Range Description
X Loc Lat float 90.0 to 90.0 User latitude
X Loc Long float 180.0 to 180.0 User longitude
Response Fields
The response has type: "local pois" and a results array of LocationResult objects:
Field Type Description
title string Business/POI name
url string Canonical URL for the location
provider url string Provider page URL
type string Always "location result"
id string POI identifier (opaque string, valid ~8 hours)
description string? Short description
postal address.type string Always "PostalAddress"
postal address.displayAddress string Formatted display address
postal address.streetAddress string? Street address
postal address.addressLocality string? City
postal address.addressRegion string? State/region
postal address.postalCode string? Postal/ZIP code
postal address.country string? Country code
contact.telephone string? Phone number
contact.email string? Email address
rating.ratingValue float? Average rating (≥0)
rating.bestRating float? Max possible rating
rating.reviewCount int? Number of reviews
rating.profile.name string? Rating provider name
rating.profile.url string? Rating provider URL
opening hours.current day object[]? Today's hours ( abbr name , full name , opens , closes )
opening hours.days object[][]? Hours for each day of the week (same structure)
coordinates [float, float]? [latitude, longitude] tuple
distance.value float? Distance from user location
distance.units string? Distance unit ( km or miles )
categories string[] Business categories (default [] )
price range string? Price indicator ( $ , $$ , $$$ , $$$$ )
serves cuisine string[]? Cuisine types (restaurants)
thumbnail.src string? Thumbnail image URL
thumbnail.original string? Original image URL
profiles object[]? External profiles ( name , url , long name , img )
reviews.reviews in foreign language bool Whether reviews in a foreign language are available
pictures.results object[]? Photo thumbnails
action object? Action to take — has type (string) and url (string)
results object[]? Related web results ( LocationWebResult with meta url )
timezone string? IANA timezone (e.g., America/Los Angeles )
timezone offset int? UTC timezone offset
Example Response
Getting POI IDs
local place search returns POI IDs directly. They also come from the Web Search API ( web search ) with result filter=locations :
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