Correction orthographique
Requiert une clé API : Obtenez-la sur https://api.search.brave.com
Plan : Inclus dans le plan Spellcheck. Voir https://api-dashboard.search.brave.com/app/subscriptions/subscribe
Démarrage rapide (cURL)
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
GET https://api.search.brave.com/res/v1/spellcheck/searchAuthentification : En-tête X-Subscription-Token: <API_KEY>
Paramètres
| Paramètre | Type | Requis | Défaut | Description |
|---|---|---|---|---|
q |
string | Oui | — | Requête à vérifier orthographiquement (1-400 caractères, max 50 mots) |
lang |
string | Non | en |
Préférence de langue (code langue de 2+ caractères, par ex. en, fr, de, pt-br, zh-hans). 51 codes supportés |
country |
string | Non | US |
Pays de recherche (code pays sur 2 lettres ou ALL) |
Champs de réponse
| Champ | Type | Description |
|---|---|---|
type |
string | Toujours "spellcheck" |
query.original |
string | La requête d'entrée telle que soumise |
results |
array | Suggestions corrigées orthographiquement. Peut être vide si aucune correction n'est trouvée |
results[].query |
string | Une version corrigée de la requête |
Exemple de réponse
{
"type": "spellcheck",
"query": {
"original": "artifical inteligence"
},
"results": [
{
"query": "artificial intelligence"
}
]
}Cas d'usage
- Nettoyage de requête pré-recherche : Vérifiez l'orthographe avant de décider quel endpoint de recherche appeler
- Interface « Voulez-vous dire ? » : Montrez aux utilisateurs une suggestion corrigée avant de lancer la recherche
- Normalisation de requêtes en masse : Nettoyez les entrées utilisateur en bulk
Notes
- Alternative intégrée : Web Search et LLM Context ont
spellcheck=truepar défaut — utilisez cet endpoint autonome uniquement quand vous avez besoin de la correction avant de chercher - Conscient du contexte : Les corrections considèrent le contexte complet de la requête, pas seulement les mots individuels