En bref. Définir country pour le pays des résultats, search_lang pour leur langue et ui_lang pour la langue d’interface souhaitée pour la réponse.

Définition : Un test de pays et de langue de l’API Brave Search définit des paramètres de requête distincts pour le pays des résultats de recherche (country), leur langue (search_lang) et la langue d’interface souhaitée pour la réponse (ui_lang). En octobre 2026, Brave indique comme valeurs par défaut respectives US, en et en-US.

Points clés

La référence de l’API de recherche web de Brave définit country comme un code pays à deux caractères et search_lang comme un code de langue de deux caractères ou plus.
Le guide Web Search de Brave décrit la langue de recherche comme un filtre sur la langue du contenu et la langue d’interface comme la langue souhaitée pour les métadonnées de la réponse.
Le guide d’authentification de Brave documente l’en-tête X-Subscription-Token pour l’authentification par clé API et recommande de stocker la clé dans une variable d’environnement ou une configuration sécurisée.

Quelles valeurs attribuer à chaque paramètre ?

La référence des requêtes présente country, search_lang et ui_lang séparément. La valeur par défaut du pays est US ; celle de la langue de recherche est en. La langue d’interface suit généralement un format langue-pays, avec en-US comme valeur par défaut. La référence énumère les options disponibles pour chaque paramètre séparément, notamment AU pour le pays et en-AU pour la langue d’interface.

Une configuration pour l’anglais d’Australie peut donc utiliser country=AU, search_lang=en et ui_lang=en-AU. Les deux paramètres de langue ont des valeurs différentes parce que l’un définit la langue des résultats et l’autre une préférence de langue d’interface pour la réponse. Des valeurs explicites rendent la configuration choisie visible dans la requête enregistrée, y compris lorsqu’une valeur choisie correspond à la valeur par défaut documentée.

À quoi ressemble une requête de test complète ?

L’exemple de pays et de langue de Brave utilise la requête nachhaltige energie, country=DE et search_lang=de pour obtenir du contenu en allemand provenant d’Allemagne. Cette requête adaptée ajoute la préférence d’interface en anglais documentée :

curl --get 'https://api.search.brave.com/res/v1/web/search' \
  --data-urlencode 'q=nachhaltige energie' \
  --data-urlencode 'country=DE' \
  --data-urlencode 'search_lang=de' \
  --data-urlencode 'ui_lang=en-US' \
  -H 'Accept: application/json' \
  -H "X-Subscription-Token: ${BRAVE_API_KEY}"

BRAVE_API_KEY contient le jeton d’abonnement. La requête sélectionne l’Allemagne et des résultats dont le contenu est en allemand, tout en demandant l’anglais comme langue d’interface de la réponse. Pour comparer les paramètres de pays, la requête de recherche et les deux paramètres de langue peuvent rester fixes tandis que country change. Une comparaison des langues des résultats fait varier search_lang en conservant les paramètres de pays et d’interface.

Quels champs de la réponse permettent de vérifier le test ?

La référence des réponses définit query.country comme le code pays de la requête, query.original comme la requête initialement soumise et query.altered comme la requête modifiée par le correcteur orthographique. Ces champs permettent de vérifier le pays et la requête utilisés dans une réponse enregistrée.

La même référence définit query.language.main comme la principale langue détectée dans la chaîne de requête. Elle définit web.results[].language comme la langue principale d’un résultat web. Un enregistrement de test peut conserver la valeur de search_lang envoyée avec ces observations distinctes. Les champs du pays et de la langue détectée de la requête peuvent prendre la valeur null dans le schéma de réponse.

Termes associés

Questions fréquentes

Quel paramètre utiliser pour obtenir des résultats dont le contenu est en allemand ?

Vous pouvez utiliser search_lang=de, comme dans l’exemple de recherche en allemand de Brave. Cet exemple l’associe à country=DE ; ui_lang contrôle séparément la langue d’interface souhaitée pour la réponse.

Que se passe-t-il si j’omets les paramètres de pays et de langue ?

La référence de l’API indique les valeurs par défaut country=US, search_lang=en et ui_lang=en-US.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Comment définir le pays et la langue pour un test de l’API Brave Search ?