> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt
# POI Descriptions
>
Published reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.
## Request contract
* **Method and path:** GET /apis/v1/brave/local/descriptions
* **Availability:** enabled
* **Request URL template:** [https://api.aisa.one/apis/v1/brave/local/descriptions](https://api.aisa.one/apis/v1/brave/local/descriptions)
* **accept:** header; optional
* **api-version:** header; optional
* **cache-control:** header; optional
* **user-agent:** header; optional
* **ids:** query; required
* **Runtime facts:** 8627d7bc05db287888574873d586ce7dca25f9fa7b4a266cb71760e824597bfc
[Complete OpenAPI definition](https://aisa.one/docs/openapi/brave-search.json)
Effective request and pricing declaration (including authentication and referenced schemas):
```json theme={null}
{
"operationId": "any_brave_search_apis_v1_brave_local_descriptions",
"method": "GET",
"path": "/apis/v1/brave/local/descriptions",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"deprecated": false,
"description": "The default supported media type is application/json.",
"examples": {
"0": {
"value": "application/json"
}
},
"in": "header",
"name": "accept",
"required": false,
"schema": {
"allOf": [
{
"enum": [
"application/json",
"*/*"
],
"title": "Accept",
"type": "string"
},
{
"default": "application/json"
}
],
"description": "The default supported media type is application/json.",
"examples": [
"application/json"
],
"title": "Media type"
}
},
{
"deprecated": false,
"description": "The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.",
"in": "header",
"name": "api-version",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.",
"title": "API version"
}
},
{
"deprecated": false,
"description": "Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.",
"in": "header",
"name": "cache-control",
"required": false,
"schema": {
"anyOf": [
{
"const": "no-cache",
"enum": [
"no-cache"
],
"title": "CacheControl",
"type": "string"
},
{
"type": "null"
}
],
"description": "Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.",
"title": "Cache control"
}
},
{
"deprecated": false,
"description": "The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.",
"examples": {
"Android": {
"description": "Android",
"value": "Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"
},
"Windows": {
"description": "Windows",
"value": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"
},
"iOS": {
"description": "iOS",
"value": "Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"
},
"macOS": {
"description": "macOS",
"value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"
}
},
"in": "header",
"name": "user-agent",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.",
"title": "User agent"
}
},
{
"deprecated": false,
"description": "A list of unique identifiers for the location. The ids are valid only for 8 hours.",
"in": "query",
"name": "ids",
"required": true,
"schema": {
"description": "A list of unique identifiers for the location. The ids are valid only for 8 hours.",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"title": "Ids",
"type": "array"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "fixed_success",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.005,
"estimate_source": "profile_seed",
"evidence_source": "request_snapshot"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
```
## Cost and request rules
Published reference price: \$0.005 USD per successful request. Account-specific pricing and final settlement may differ.
Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
* **Default request reference estimate (USD):** 0.005
* **Cost contract:** fixed\_success
* **Published reference multiplier:** 1.0
* **Settlement evidence source:** request\_snapshot
## OpenAPI
````yaml openapi/brave-search.json GET /apis/v1/brave/local/descriptions
openapi: 3.1.0
info:
description: ''
title: Brave Search
version: '1'
x-aisa-capabilities:
idempotency: Idempotency-Key
max_price: X-AISA-Max-Price-USD
quote:
header: X-AISA-Cost-Mode
value: quote
x-aisa-catalogs:
brave-search:
description: ''
title: Brave Search
x-aisa-capabilities:
idempotency: Idempotency-Key
max_price: X-AISA-Max-Price-USD
quote:
header: X-AISA-Cost-Mode
value: quote
x-aisa-document:
facts_hash: 8627d7bc05db287888574873d586ce7dca25f9fa7b4a266cb71760e824597bfc
generator_version: '3'
protocol_version: '1'
schema_version: '1'
x-aisa-plans:
builder: 1
display_plan: payg
payg: 1
similarweb_payg: 1
team: 1
version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
x-aisa-configured-paths:
- /apis/v1/brave/images/search
- /apis/v1/brave/llm/context
- /apis/v1/brave/local/descriptions
- /apis/v1/brave/local/place_search
- /apis/v1/brave/local/pois
- /apis/v1/brave/news/search
- /apis/v1/brave/spellcheck/search
- /apis/v1/brave/suggest/search
- /apis/v1/brave/videos/search
- /apis/v1/brave/web/rich
- /apis/v1/brave/web/search
x-aisa-document:
composer_version: '20'
document_hash: sha256:dd3bf51bf816c65187edaf986eabe02a048ea79407f7f5e64e18c08fd29983cf
facts_hash: 8627d7bc05db287888574873d586ce7dca25f9fa7b4a266cb71760e824597bfc
generator_version: '3'
protocol_version: '1'
response_pending: []
schema_version: '1'
x-aisa-plans:
builder: 1
display_plan: payg
payg: 1
similarweb_payg: 1
team: 1
version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
x-aisa-provider: brave-search
servers:
- url: https://api.aisa.one
security:
- bearerAuth: []
paths:
/apis/v1/brave/local/descriptions:
get:
tags:
- default
summary: POI Descriptions
description: >-
Published reference price: $0.005 USD per successful request.
Account-specific pricing and final settlement may differ.
operationId: any_brave_search_apis_v1_brave_local_descriptions
parameters:
- deprecated: false
description: The default supported media type is application/json.
examples:
'0':
value: application/json
in: header
name: accept
required: false
schema:
allOf:
- enum:
- application/json
- '*/*'
title: Accept
type: string
- default: application/json
description: The default supported media type is application/json.
examples:
- application/json
title: Media type
- deprecated: false
description: >-
The API version to use. This is denoted by the
format YYYY-MM-DD. Default is the
latest that is available. Read more about API versioning.
in: header
name: api-version
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: >-
The API version to use. This is denoted by the
format YYYY-MM-DD. Default is the
latest that is available. Read more about API versioning.
title: API version
- deprecated: false
description: >-
Brave Search will return cached content by default.
To prevent caching set the Cache-Control header to
no-cache. This is currently done as
best effort.
in: header
name: cache-control
required: false
schema:
anyOf:
- const: no-cache
enum:
- no-cache
title: CacheControl
type: string
- type: 'null'
description: >-
Brave Search will return cached content by
default. To prevent caching set the Cache-Control
header to no-cache. This is currently
done as best effort.
title: Cache control
- deprecated: false
description: >-
The user agent originating the request. Brave search
can utilize the user agent to provide a different
experience depending on the device as described by the
string. The user agent should follow the commonly
used browser agent strings on each platform. For
more information on curating user agents, see RFC
9110.
examples:
Android:
description: Android
value: >-
Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like
Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36
Windows:
description: Windows
value: >-
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36
(KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36
iOS:
description: iOS
value: >-
Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X)
AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63
Mobile/15E148 Safari/604.1
macOS:
description: macOS
value: >-
Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36
(KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36
in: header
name: user-agent
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: >-
The user agent originating the request. Brave
search can utilize the user agent to provide a
different experience depending on the device as
described by the string. The user agent should
follow the commonly used browser agent strings on
each platform. For more information on curating user
agents, see RFC
9110.
title: User agent
- deprecated: false
description: >-
A list of unique identifiers for the location. The ids are valid
only for 8 hours.
in: query
name: ids
required: true
schema:
description: >-
A list of unique identifiers for the location. The ids are valid
only for 8 hours.
items:
type: string
maxItems: 20
minItems: 1
title: Ids
type: array
responses:
'200':
content:
application/json:
schema:
$ref: >-
#/components/schemas/ResponseB91D37C29Ffe_LocalDescriptionsSearchApiResponse
description: Successful Response
default:
content:
application/json:
schema: {}
description: >-
Error response; upstream passthrough responses may use provider
formats
components:
schemas:
ResponseB91D37C29Ffe_LocalDescriptionsSearchApiResponse:
properties:
results:
anyOf:
- items:
anyOf:
- $ref: >-
#/components/schemas/ResponseB91D37C29Ffe_LocationDescription
- type: 'null'
type: array
- type: 'null'
description: >-
The list of location descriptions for the given location
identifiers.
title: Results
type:
const: local_descriptions
default: local_descriptions
enum:
- local_descriptions
title: Type
type: string
title: LocalDescriptionsSearchApiResponse
type: object
ResponseB91D37C29Ffe_LocationDescription:
description: AI generated description of a location result.
properties:
description:
anyOf:
- type: string
- type: 'null'
description: AI generated description of the location with the given id.
title: Description
id:
description: A temporary id of the location with this description.
title: Id
type: string
type:
const: local_description
default: local_description
description: >-
The type of a location description. The value is always
local_description.
enum:
- local_description
title: Type
type: string
required:
- id
title: LocationDescription
type: object
securitySchemes:
bearerAuth:
scheme: bearer
type: http
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.