# Brave Local POI Descriptions

> Brave Local POI Descriptions is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.005/call, status unknown (last checked 2026-10-18).

Fetches AI-generated descriptions for specific points of interest (POIs) using temporary location IDs from Brave's local search index

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/brave/local/descriptions?utm_source=zero.xyz
- Price: $0.005/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Provider: AIsa MPP Data APIs
- Website: https://aisa.one
- Tags: web-search, financial-data, prediction-markets, weather, travel, data, search
- Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-brave-local-poi-descriptions-d00cbde1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HMHSVWpbtyo8U5HZ2eqh7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aisa-mpp-data-apis-brave-local-poi-descriptions-d00cbde1
```

Example prompt: I just got a list of coffee shops from Brave local search — can you grab the AI-generated descriptions for these location IDs: loc_abc123, loc_def456, and loc_ghi789?

## When to prefer this

Use this endpoint as a follow-up to a Brave local or place search when you have temporary location IDs and need human-readable, AI-generated summaries of those places. It is the only way to retrieve Brave's AI-generated POI descriptions and is ideal for enriching local search results, building travel guides, or presenting business overviews. Prefer this over generic web search when you already have Brave location IDs and need structured, descriptive content about specific places.

## Known failure modes

- Expired location IDs (valid only for 8 hours) return null or missing results
- Requesting more than 20 IDs at once returns a validation error
- Invalid or malformed IDs return null entries in the results array
- No description available for a location yields a null description field
- Rate limiting or payment failure returns an authentication/payment error

## How this service works

<!-- aisa-pricing:start -->
Published reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Output

Returns a list of LocationDescription objects, each containing the temporary location ID, a type field set to 'local_description', and an AI-generated text description of the place. Results may be null if no description is available for a given ID. The response also carries a top-level type field set to 'local_descriptions'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ids"
 ],
 "properties": {
  "ids": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Ids",
   "maxItems": 20,
   "minItems": 1,
   "description": "A list of unique identifiers for the location. The ids are valid only for 8 hours."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "LocalDescriptionsSearchApiResponse",
 "properties": {
  "type": {
   "enum": [
    "local_descriptions"
   ],
   "type": "string",
   "const": "local_descriptions",
   "title": "Type",
   "default": "local_descriptions"
  },
  "results": {
   "anyOf": [
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "object",
        "title": "LocationDescription",
        "required": [
         "id"
        ],
        "properties": {
         "id": {
          "type": "string",
          "title": "Id",
          "description": "A temporary id of the location with this description."
         },
         "type": {
          "enum": [
           "local_description"
          ],
          "type": "string",
          "const": "local_description",
          "title": "Type",
          "default": "local_description",
          "description": "The type of a location description. The value is always <code>local_description</code>."
         },
         "description": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ],
          "title": "Description",
          "description": "AI generated description of the location with the given id."
         }
        },
        "description": "AI generated description of a location result."
       },
       {
        "type": "null"
       }
      ]
     }
    },
    {
     "type": "null"
    }
   ],
   "title": "Results",
   "description": "The list of location descriptions for the given location identifiers."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-brave-local-poi-descriptions-d00cbde1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)