Suggest

This is Brave's autocomplete API packaged as a skill. It's built for sub-100ms responses, so you can wire it directly into search-as-you-type UIs with a 150-300ms debounce. The basic mode just returns query suggestions, but flip on rich mode and you get entity data with titles, descriptions, and images, which is great for preview cards. It handles typos without needing a separate spellcheck pass. The main gotcha is that rich suggestions require a paid Brave Search plan on top of the Suggest plan. If you're building any kind of search interface or need to clean up ambiguous queries before hitting a RAG pipeline, this does exactly that job without reinventing the wheel.

skills.sh installs: 1.1K
GitHub stars: 196
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add brave/brave-search-skills --skill suggest --agent claude-code

Installs into .claude/skills of the current project.

Files

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

SKILL.md on GitHub

Details

Repository: github.com/brave/brave-search-skills
First seen: Jun 3, 2026

More from brave/brave-search-skills

All 11