En bref. Activez extra_snippets=true dans une requête de recherche web Brave et lisez le tableau extra_snippets de chaque résultat pour obtenir jusqu’à cinq extraits supplémentaires de la page.

Définition : Un extrait de résultat de recherche (snippet) est un passage d’une page renvoyé en réponse à une requête. Au 17 octobre 2026, la documentation de Brave Search API indique que extra_snippets=true permet de demander jusqu’à cinq extraits supplémentaires par résultat de recherche, correspondant à d’autres passages de la page.

Points clés

La référence de l’API de recherche web de Brave définit extra_snippets comme un paramètre de requête booléen.
Le guide Web Search place les extraits alternatifs dans un tableau extra_snippets au sein de chaque élément de web.results.
Le guide de démarrage Quickstart de Brave exige une clé API dans l’en-tête de requête X-Subscription-Token.

Comment construire la requête ?

Le guide Web Search fournit cette requête pour la recherche « python web frameworks ». L’URL associe les termes de recherche, transmis par q, au paramètre qui active les extraits supplémentaires :

curl "https://api.search.brave.com/res/v1/web/search?q=python+web+frameworks&extra_snippets=true" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

<YOUR_API_KEY> est une valeur à remplacer par la clé d’abonnement. Le guide de démarrage Quickstart de Brave décrit la création de cette clé dans la rubrique API Keys du tableau de bord, après l’activation d’une offre. Il demande également aux développeurs de garder cette clé confidentielle et de ne pas l’exposer dans du code côté client. Pour un site web, la requête authentifiée doit donc être effectuée dans le code côté serveur.

Où se trouvent les passages alternatifs dans la réponse ?

Le guide Web Search présente un résultat comprenant un title, une url, une description contenant l’extrait principal et un tableau extra_snippets contenant les extraits alternatifs. Chacun de ces extraits provient de la page correspondant au résultat. Conserver les extraits avec l’URL de leur résultat préserve l’association entre un passage et sa source.

La référence de l’API définit web.results.extra_snippets comme un tableau de chaînes de caractères pouvant prendre la valeur null. Le traitement de la réponse doit donc prévoir cette valeur avant de parcourir les extraits. La référence indique aussi que description peut prendre la valeur null : le code qui combine l’extrait principal et les extraits alternatifs doit donc traiter ces deux champs indépendamment.

Ce paramètre modifie-t-il le nombre de résultats de recherche ?

La référence de l’API attribue le nombre de résultats de recherche renvoyés à un paramètre distinct, count. Le paramètre extra_snippets demande des passages alternatifs au sein des résultats. La limite documentée de cinq s’applique aux extraits supplémentaires de chaque résultat, en complément de son extrait principal.

Le guide Web Search mentionne l’aperçu du contenu avant l’ouverture d’une page et l’évaluation de la pertinence parmi les usages de ces extraits. Ceux-ci apportent davantage de contexte sur la page dans la réponse de recherche pour évaluer si un résultat répond à la requête.

Termes associés

Questions fréquentes

Puis-je demander un nombre fixe d’extraits supplémentaires ?

Vous activez la fonctionnalité avec un booléen. La référence de l’API indique un maximum de cinq extraits supplémentaires : votre code doit donc accepter un nombre variable d’extraits.

Où lire l’extrait principal ?

Utilisez description dans le résultat concerné. Le guide Web Search présente ce champ à côté de extra_snippets, ce qui vous permet de conserver l’extrait principal tout en lisant les extraits alternatifs.

Sources

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

Comment récupérer des passages supplémentaires des pages sources avec Brave Search API ?