# Brave Suggest Search via AIsa

> Brave Suggest Search via AIsa is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.0005/call, status unknown (last checked 2026-10-14).

Returns autocomplete/typeahead query suggestions for a partial search term using Brave's suggestion engine

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/brave/suggest/search?utm_source=zero.xyz
- Price: $0.0005/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- 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-suggest-search-via-aisa-51d11d70
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6uNztd_yhXYD78DmR2sIJ

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-suggest-search-via-aisa-51d11d70
```

Example prompt: Can you give me up to 10 Brave search suggestions for 'climate change solut' in English for the US, so I can autocomplete the user's query?

## When to prefer this

Use this endpoint when you need real-time autocomplete or typeahead query suggestions powered by Brave Search, especially when you want to avoid Google/Bing dependence. It is ideal for populating search suggestion dropdowns, expanding partial user queries, or discovering popular related search terms. At $0.0005/call it is cost-effective for high-frequency typeahead scenarios. Prefer this over full-text search endpoints when you only need completions, not full search result pages.

## Known failure modes

- Empty query string returns a 422 validation error — q is required and must be at least 1 character
- Query exceeding 400 characters or 50 words returns a validation error
- Unsupported language or country code returns a validation error
- Rich results requested without an active paid autosuggest subscription returns limited or no enriched data
- Fewer results than requested count may be returned if Brave has insufficient suggestions for the query
- Network or upstream Brave Search service outage returns a 5xx error

## How this service works

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

## Output

Returns a JSON object containing the original query and an array of suggested query completions. Each suggestion includes the completed query string, a type tag (query, entity, or calculator), and optionally enriched metadata like a title, description, and image URL when rich mode is enabled.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string",
   "title": "The user's suggest search query term.",
   "maxLength": 400,
   "minLength": 1,
   "description": "The user’s suggest search query term. Query can not be empty. The max query length is 400 characters, and the word limit is 50 words."
  },
  "lang": {
   "allOf": [
    {
     "enum": [
      "ar",
      "eu",
      "bn",
      "bg",
      "ca",
      "zh-hans",
      "zh-hant",
      "hr",
      "cs",
      "da",
      "nl",
      "en",
      "en-gb",
      "et",
      "fi",
      "fr",
      "gl",
      "de",
      "el",
      "gu",
      "he",
      "hi",
      "hu",
      "is",
      "it",
      "ja",
      "jp",
      "kn",
      "ko",
      "lv",
      "lt",
      "ms",
      "ml",
      "mr",
      "nb",
      "pl",
      "pt-br",
      "pt-pt",
      "pa",
      "ro",
      "ru",
      "sr",
      "sk",
      "sl",
      "es",
      "sv",
      "ta",
      "te",
      "th",
      "tr",
      "uk",
      "vi"
     ],
     "type": "string",
     "title": "Language"
    },
    {
     "default": "en"
    }
   ],
   "description": "The suggest search language preference, where potentially the results could come from. The 2 or more character language code for which the suggest search results are provided. This is a just a hint for calculating suggest responses."
  },
  "rich": {
   "type": "boolean",
   "title": "Rich",
   "default": false,
   "description": "Whether to enhance suggestions with rich results. This requires a paid autosuggest subscription."
  },
  "count": {
   "type": "integer",
   "title": "Count",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "The number of suggestion search results returned in response. The actual number of results delivered may be less than requested. Minimum is 1, maximum is 20. The default is 5."
  },
  "country": {
   "allOf": [
    {
     "enum": [
      "AR",
      "AU",
      "AT",
      "BE",
      "BR",
      "CA",
      "CL",
      "DK",
      "FI",
      "FR",
      "DE",
      "GR",
      "HK",
      "IN",
      "ID",
      "IT",
      "JP",
      "KR",
      "MY",
      "MX",
      "NL",
      "NZ",
      "NO",
      "CN",
      "PL",
      "PT",
      "PH",
      "RU",
      "SA",
      "ZA",
      "ES",
      "SE",
      "CH",
      "TW",
      "TR",
      "GB",
      "US",
      "ALL"
     ],
     "type": "string",
     "title": "SearchCountry"
    },
    {
     "default": "US"
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "SuggestSearchApiResponse",
 "required": [
  "query"
 ],
 "properties": {
  "type": {
   "enum": [
    "suggest"
   ],
   "type": "string",
   "const": "suggest",
   "title": "Type",
   "default": "suggest"
  },
  "query": {
   "type": "object",
   "title": "OriginalQuery",
   "required": [
    "original"
   ],
   "properties": {
    "original": {
     "type": "string",
     "title": "Original",
     "description": "The original query that was requested."
    }
   }
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "SuggestResult",
    "required": [
     "query"
    ],
    "properties": {
     "img": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Img",
      "description": "The suggested query enriched image URL."
     },
     "type": {
      "anyOf": [
       {
        "enum": [
         "query",
         "entity",
         "calculator"
        ],
        "type": "string",
        "title": "SuggestType",
        "description": "<p>Kind tag on a rich suggestion entry.</p>\n<p>Open set: mixer emits these today, but we may add Rich Header verticals\nover time, so consumers must render an unrecognised value as plain text.</p>"
       },
       {
        "type": "null"
       }
      ],
      "description": "Kind of suggestion, currently <code>query</code> or <code>entity</code>. New kinds may be added, so treat an unrecognised value as a plain query suggestion."
     },
     "query": {
      "type": "string",
      "title": "Query",
      "description": "Suggested query completion."
     },
     "title": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Title",
      "description": "The suggested query enriched title."
     },
     "is_entity": {
      "anyOf": [
       {
        "type": "boolean"
       },
       {
        "type": "null"
       }
      ],
      "title": "Is Entity",
      "description": "Whether the suggested enriched query is an entity. Deprecated: use <code>type</code> instead."
     },
     "description": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Description",
      "description": "The suggested query enriched description."
     }
    }
   },
   "title": "Results",
   "default": [],
   "description": "The list of suggestions f
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-brave-suggest-search-via-aisa-51d11d70/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)