En bref. Comparez query.altered à query.original pour examiner une correction orthographique signalée, et définissez spellcheck=false pour désactiver la vérification orthographique.
Définition : L’API Brave Search indique la requête de recherche corrigée sur le plan orthographique dans
query.altered. Au 17 octobre 2026, Brave indique que la correction orthographique est activée par défaut et que la requête modifiée est toujours utilisée pour la recherche lorsque le correcteur orthographique est activé.
Points clés
- La documentation de référence de l’API Web Search de Brave définit
query.originalcomme la requête demandée etquery.alteredcomme la requête modifiée par le correcteur orthographique. - Le guide Web Search de Brave date l’ajout du paramètre
spellcheckdu 11 octobre 2023. - Le guide de démarrage rapide de Brave exige une clé API dans l’en-tête
X-Subscription-Tokendes requêtes.
Quel champ de la réponse indique la modification ?
Le schéma de réponse définit query comme la requête de recherche et ses modifications utilisées pour la recherche. Dans cet objet, original contient le texte demandé, tandis que altered contient la modification apportée par le correcteur orthographique. La comparaison de ces chaînes permet de repérer une correction orthographique signalée lorsque altered contient un texte différent.
Le schéma définit altered comme une chaîne pouvant prendre la valeur null. Le code qui lit la réponse doit gérer cette valeur avant de comparer les chaînes. Le champ distinct query.cleaned contient la requête nettoyée et normalisée. Sa description porte sur la normalisation ; le champ spécifiquement prévu pour les corrections orthographiques est query.altered.
Lors d’un test de recherche portant sur un site web, conserver l’objet query renvoyé avec le texte soumis permet de voir la correction orthographique au moment de l’examen. Il s’agit d’un usage pratique des champs documentés pour vérifier les résultats concernant une marque ou le sujet d’une page.
Comment désactiver la correction orthographique pour une comparaison ?
La documentation de référence des paramètres définit spellcheck comme un booléen dont la valeur par défaut est true. Le définir explicitement sur false désactive cette vérification orthographique. Le schéma de réponse expose aussi query.spellcheck_off, un booléen pouvant prendre la valeur null qui indique si la correction orthographique est désactivée pour la requête.
La requête suivante adapte le point de terminaison (endpoint) et l’exemple de requête du guide Web Search de Brave, en y ajoutant le paramètre documenté de correction orthographique :
curl 'https://api.search.brave.com/res/v1/web/search?q=machine+learning+tutorials&spellcheck=false' \
-H 'X-Subscription-Token: YOUR_API_KEY'
Le guide de démarrage rapide de Brave explique que la clé API se place dans cet en-tête et doit rester confidentielle. L’exécution de la commande nécessite de remplacer la valeur fictive par une clé valide.
Pour effectuer une comparaison, un test peut envoyer le même q avec spellcheck=true et spellcheck=false, en conservant chaque objet query renvoyé. L’examen de original, altered et spellcheck_off relie l’observation au paramétrage de la requête. Cette comparaison vérifie le traitement orthographique signalé pour le texte soumis.
Termes associés
Questions fréquentes
L’activation de la correction orthographique renvoie-t-elle seulement une suggestion ?
La documentation de référence Web Search de Brave indique que la requête modifiée est toujours utilisée pour la recherche lorsque le correcteur orthographique est activé. Vous pouvez consulter query.altered pour lire cette modification.
Puis-je demander uniquement des résultats web et consulter quand même la requête ?
La même documentation précise, dans la description de result_filter, que la réponse inclut toujours query et type. Vous pouvez donc utiliser result_filter=web tout en conservant les informations sur la requête pour les examiner.
Sources
- Brave, « Web Search API reference », sans date
- Brave, « Web Search », sans date
- Brave, « Quickstart », sans date
Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO