56 results available

suggest

brave

·

Last changed

Hardened

This skill has been hardened by Chainguard

Last changed

This version passed the hardening gate. Hardening applied 2 targeted changes and preserved all other text. Classified findings before hardening: 1. Classified findings closed: 0. Classified findings remaining: 1. Unclassified scanner findings remaining: 0. Review findings closed: 5. Review findings remaining: 10.

Open before hardening

1

Medium

Open after hardening

1

Medium

Expand	File	Group	Subtype	Severity	Status
	SKILL.md	Sensitive Data & Secret Exposure	Data exfiltration	Medium	Open

1 finding

SKILL.md

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)

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

Parameter	Type	Required	Default	Description
`q`	string	Yes	—	Suggest search query (1-400 chars, max 50 words)
`lang`	string	No	`en`	Language preference (2+ char language code, e.g. `fr`, `de`, `zh-hans`)
`country`	string	No	`US`	Search country (2-letter country code or `ALL`)
`count`	int	No	`5`	Number of suggestions (1-20). Actual results may be fewer
`rich`	bool	No	`false`	Enhance with entity info (title, description, image). Paid Search plan required

Response Fields

Field	Type	Description
`type`	string	Always `"suggest"`
`query.original`	string	The original suggest search query
`results`	array	List of suggestions (may be empty)
`results[].query`	string	Suggested query completion
`results[].is_entity`	bool?	Whether the suggested enriched query is an entity (rich only)
`results[].title`	string?	The suggested query enriched title (rich only)
`results[].description`	string?	The suggested query enriched description (rich only)
`results[].img`	string?	The suggested query enriched image URL (rich only)

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.
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

Install

Install with chainctl


chainctl skill install public/brave/suggest:latest

Get started with chainctl

View source

Harden your own skills

Bring Chainguard's hardening pipeline to your first-party skills — custom rulesets, automated remediation, full audit trail.

Provenance

Upstream sourcehttps://github.com/brave/brave-search-skills

Upstream commit2827ed3c4e51e02e31c538d1d11695d4e245e2b3

OCI reference

skills.cgr.dev/public/github.com/brave/skills/suggest:latest

License

MIT

Files

HARDENING.md

LICENSE

SKILL.md

The trusted source for open source

Talk to an expert

Privacy

Terms

© 2026 Chainguard, Inc. All Rights Reserved.
Chainguard® and the Chainguard logo are registered trademarks of Chainguard, Inc. in the United States and/or other countries.
The other respective trademarks mentioned on this page are owned by the respective companies and use of them does not imply any affiliation or endorsement.