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