Suggest

Suggest / Autocomplete

Requires API Key: Get one at https://api.search.brave.com

Plan: Included in the Suggest plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe

Quick Start (cURL)

Basic Suggestions

curl -s "https://api.search.brave.com/res/v1/suggest/search?q=how+to+" \  -H "Accept: application/json" \  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"

With All Parameters

curl -s "https://api.search.brave.com/res/v1/suggest/search" \  -H "Accept: application/json" \  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \  -G \  --data-urlencode "q=albert" \  --data-urlencode "country=US" \  --data-urlencode "lang=en" \  --data-urlencode "count=10" \  --data-urlencode "rich=true"

Endpoint

GET https://api.search.brave.com/res/v1/suggest/search

Authentication: X-Subscription-Token: <API_KEY> header

Optional Headers:

• Accept-Encoding: gzip — Enable response compression

Parameters

Response Fields

Fields with null values are excluded from the response. Non-rich results contain only the query field.

Rich Response Example (rich=true)

{  "type": "suggest",  "query": { "original": "albert" },  "results": [    {      "query": "albert einstein",      "is_entity": true,      "title": "Albert Einstein",      "description": "German-born theoretical physicist",      "img": "https://imgs.search.brave.com/..."    },    { "query": "albert einstein quotes", "is_entity": false }  ]}

Use Cases

• Search-as-you-type UI: Real-time autocomplete dropdown. Debounce 150-300ms.
• Query refinement for RAG: Expand partial/ambiguous queries before calling web-search or llm-context.
• Entity detection: Use rich=true to detect entities with title, description, and image for preview cards.
• Typo-tolerant input: Get clean suggestions from misspelled input without separate spellcheck.

Notes

• Latency: Designed for <100ms response times
• Country/lang: Hints for suggestion relevance, not strict filters
• Typo handling: Suggestions handle common typos without separate spellcheck