Loading...
Loading...
USE FOR query autocomplete/suggestions. Fast (<100ms). Returns suggested queries as user types. Supports rich suggestions with entity info. Typo-resilient.
npx skill4agent add brave/brave-search-skills suggestRequires API Key: Get one at https://api.search.brave.comPlan: Included in the Suggest plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe
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}"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"GET https://api.search.brave.com/res/v1/suggest/searchX-Subscription-Token: <API_KEY>Accept-Encoding: gzip| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| string | Yes | — | Suggest search query (1-400 chars, max 50 words) |
| string | No | | Language preference (2+ char language code, e.g. |
| string | No | | Search country (2-letter country code or |
| int | No | | Number of suggestions (1-20). Actual results may be fewer |
| bool | No | | Enhance with entity info (title, description, image). Paid Search plan required |
| Field | Type | Description |
|---|---|---|
| string | Always |
| string | The original suggest search query |
| array | List of suggestions (may be empty) |
| string | Suggested query completion |
| bool? | Whether the suggested enriched query is an entity (rich only) |
| string? | The suggested query enriched title (rich only) |
| string? | The suggested query enriched description (rich only) |
| string? | The suggested query enriched image URL (rich only) |
nullqueryrich=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 }
]
}web-searchllm-contextrich=true