Spellcheck

by brave62793e0c49edNo license183 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 2 weeks ago

USE FOR spell correction. Returns corrected query if misspelled. Most search endpoints have spellcheck built-in; use this only for pre-search query cleanup or "Did you mean?" UI.

Instructions onlyWriting & Content

AI-generated overview

Calls the Brave Spellcheck API to return a corrected version of a misspelled search query.

What it does: This skill documents how to call the Brave Spellcheck endpoint with a query, language and country, and how to read the JSON response. It returns the original query plus any spell-corrected suggestions, which may be empty when no correction is found. It is instructions only and ships no scripts.
When to use it: Use it when you need to clean up or normalize a user query before running a search, or when you want to show a "Did you mean?" suggestion. It is intended for pre-search cleanup rather than for searches that already include built-in spellcheck.
Requirements: A Brave Search API key sent in the X-Subscription-Token header, a subscription that includes the Spellcheck plan, and network access to api.search.brave.com. No scripts are included.

Spellcheck

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

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

Quick Start (cURL)

bash

curl -s "https://api.search.brave.com/res/v1/spellcheck/search" \  -H "Accept: application/json" \  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \  -G \  --data-urlencode "q=artifical inteligence" \  --data-urlencode "lang=en" \  --data-urlencode "country=US"

curl -s "https://api.search.brave.com/res/v1/spellcheck/search" \  -H "Accept: application/json" \  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \  -G \  --data-urlencode "q=artifical inteligence" \  --data-urlencode "lang=en" \  --data-urlencode "country=US"

Endpoint

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

Parameters

Parameter	Type	Required	Default	Description
`q`	string	Yes	—	Query to spell check (1-400 chars, max 50 words)
`lang`	string	No	`en`	Language preference (2+ char language code, e.g. `en`, `fr`, `de`, `pt-br`, `zh-hans`). 51 codes supported
`country`	string	No	`US`	Search country (2-letter country code or `ALL`)

Response Fields

Field	Type	Description
`type`	string	Always `"spellcheck"`
`query.original`	string	The input query as submitted
`results`	array	Spell-corrected suggestions. May be empty when no correction is found
`results[].query`	string	A corrected version of the query

Example Response

json

{  "type": "spellcheck",  "query": {    "original": "artifical inteligence"  },  "results": [    {      "query": "artificial intelligence"    }  ]}

{  "type": "spellcheck",  "query": {    "original": "artifical inteligence"  },  "results": [    {      "query": "artificial intelligence"    }  ]}

Use Cases

Pre-search query cleanup: Check spelling before deciding which search endpoint to call
"Did you mean?" UI: Show users a corrected suggestion before running the search
Batch query normalization: Clean up user inputs in bulk

Notes

Built-in alternative: Web Search and LLM Context have spellcheck=true by default — use this standalone endpoint only when you need the correction before searching
Context-aware: Corrections consider the full query context, not just individual words

Source and attribution

Source:brave/brave-search-skillsinskills/spellcheckat commit62793e0

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Spellcheck

Spellcheck

Quick Start (cURL)

Endpoint

Parameters

Response Fields

Example Response

Use Cases

Notes

Source and attribution

More from brave/brave-search-skills

Web Search

Suggest

Videos Search

Local Pois

News Search

Local Descriptions

More in Writing & Content

Doc Coauthoring

Writing Guidelines

Job Post Builder

Write Spec

Draft Content

Brand Voice Enforcement