/local-pois

name: local-pois
description: 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.

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

| 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

{
  "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"