En bref. Transmettre des règles hébergées ou intégrées via goggles, avec des règles de site et une règle générique $discard pour limiter les résultats aux sites correspondants.

Définition : Un Goggle de Brave est un ensemble de règles qui modifie l’ordre ou l’inclusion des résultats issus de l’index de recherche de Brave. Dans l’API Web Search, le paramètre goggles accepte l’URL d’un fichier de règles hébergé ou des règles intégrées à la requête (inline) pour sélectionner des sites et cibler des motifs d’URL.

Points clés

Au 17 octobre 2026, la référence de l’API Web Search de Brave accepte jusqu’à 3 Goggles par requête et indique que goggles_id est obsolète.
La documentation Goggles de Brave autorise les URL de fichiers hébergés et les définitions intégrées dans une même requête. Plusieurs règles au sein d’une définition intégrée sont séparées par des sauts de ligne.
Le guide de démarrage de la syntaxe de Brave prend en charge les restrictions par domaine avec site=, les motifs d’URL et l’action explicite $discard pour supprimer les résultats correspondants.
Le guide Getting Started de Brave explique qu’une règle générique $discard exclut les résultats qui ne correspondent à aucune instruction du Goggle.

Comment les règles sont-elles transmises dans la requête ?

La référence de l’API Web Search définit goggles comme une chaîne de caractères ou une liste de chaînes. La requête illustrative suivante utilise une exclusion de domaine intégrée, tirée de l’exemple de filtrage des réseaux sociaux de Brave. Le jeton d’abonnement authentifie la requête.

curl -G 'https://api.search.brave.com/res/v1/web/search' \
  --data-urlencode 'q=web development' \
  --data-urlencode 'goggles=$discard,site=facebook.com' \
  -H 'X-Subscription-Token: YOUR_API_KEY'

La documentation Goggles de Brave précise qu’il faut répéter le paramètre de requête goggles pour utiliser plusieurs Goggles. Une seule valeur peut contenir plusieurs règles : les caractères de saut de ligne sont encodés sous la forme %0A dans la chaîne de requête. Les fichiers hébergés permettent d’utiliser des ensembles de règles plus volumineux sans placer chaque instruction dans l’URL.

Quelles règles de filtrage sont prises en charge ?

Le guide de démarrage de la syntaxe définit une instruction par ligne. Un motif simple peut correspondre à n’importe quelle partie d’une URL ; site= restreint une instruction à un domaine. Ces exemples tirés du fichier ciblent toutes les pages d’un site, puis le chemin de son blog :

$site=brave.com
/blog/$site=brave.com

Une règle sans action explicite fait remonter les résultats correspondants dans le classement. $downrank abaisse leur position et $discard les supprime. Les motifs acceptent * pour zéro ou plusieurs caractères, | au début ou à la fin pour imposer une correspondance avec le préfixe ou le suffixe, et ^ pour un délimiteur d’URL ou la fin de l’URL.

Pour limiter la sélection aux sites correspondants, le guide Getting Started indique d’utiliser une règle générique $discard. La combinaison de cette règle par défaut avec la syntaxe de sélection d’un site donne cet exemple :

$discard
$site=brave.com

La première ligne exclut les résultats sans correspondance ; la seconde conserve les résultats correspondant au site de Brave. Sans l’exclusion générique, d’autres résultats pertinents peuvent subsister. Une exclusion ciblée prend le pas sur une règle qui fait remonter ou descendre le même résultat.

Comment rendre un Goggle hébergé disponible ?

La documentation Goggles de Brave mentionne les dépôts publics GitHub, les GitHub Gists et les fichiers publics ou snippets GitLab comme options d’hébergement. Le fichier comprend les métadonnées name, description, public et author, écrites sur des lignes commençant par !.

L’URL du fichier hébergé est soumise sur la page de création de Goggles de Brave avant toute utilisation de l’API. L’URL enregistrée devient ensuite la valeur de goggles dans la requête.

Termes associés

Questions fréquentes

Puis-je combiner un fichier hébergé avec des règles intégrées ?

Oui. La documentation Goggles de Brave autorise un mélange d’URL de fichiers hébergés et de définitions intégrées, dans la limite de 3 valeurs par requête.

Comment mettre à jour un Goggle hébergé ?

Vous modifiez le fichier hébergé et soumettez à nouveau son URL sur la page de création. Le guide Getting Started de Brave précise que cette nouvelle soumission déclenche une nouvelle récupération du fichier et rend les règles mises à jour disponibles dans la recherche.

Sources

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

Comment appliquer une sélection personnalisée de sites avec Brave Goggles ?