En bref. Brave Answers API accepte un message utilisateur et peut transmettre une réponse en flux continu avec des citations de sources balisées lorsque les citations sont activées hors du mode recherche approfondie.

Définition : Brave Answers API est une interface de programmation d’application qui produit des réponses à partir de recherches sur le Web et peut renvoyer des citations de sources intégrées au texte. Au 17 octobre 2026, Brave documente un point de terminaison (endpoint) compatible avec le format chat completions d’OpenAI, avec des données supplémentaires balisées pour les citations et l’utilisation des ressources.

Points clés

Le guide Answers de Brave indique que les requêtes sont envoyées à https://api.search.brave.com/res/v1/chat/completions.
La référence de l’API accepte exactement un message user dans le tableau messages.
La documentation Skills de Brave fournit un exemple de recherche unique avec une requête bloquante et un exemple de recherche approfondie en flux continu (streaming), qui utilisent le même point de terminaison.

Que contient une requête avec citations ?

La référence de l’API prévoit un champ textuel content dans le message utilisateur. Elle accepte les identifiants de modèle brave et brave-pro, avec brave-pro par défaut. Les balises de citation intégrées au texte nécessitent stream: true et enable_citations: true ; elles sont désactivées par défaut et ne sont pas prises en charge en mode recherche approfondie.

Cette requête adapte l’exemple cURL de la documentation pour activer les citations :

curl -X POST "https://api.search.brave.com/res/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "x-subscription-token: <YOUR_BRAVE_SEARCH_API_KEY>" \
  -d '{
    "model": "brave",
    "messages": [{"role": "user", "content": "What is the second highest mountain?"}],
    "stream": true,
    "enable_citations": true,
    "enable_research": false
  }'

Le guide de démarrage rapide Skills de Brave présente aussi des requêtes HTTP directes avec un jeton d’abonnement. Une requête bloquante utilise stream: false ; l’exemple de recherche approfondie définit stream et enable_research sur true.

Comment les réponses et les sources sont-elles renvoyées ?

Le guide du format de réponse de Brave décrit un texte de réponse ordinaire entrecoupé de chaînes balisées contenant du JSON, un format de données structurées. Une balise de citation contient les champs start_index, end_index, number, url, favicon et snippet. L’exemple du guide suit cette structure :

<citation>{"start_index": 0, "end_index": 10, "number": 1, "url": "https://...", "favicon": "...", "snippet": "..."}</citation>

L’analyseur syntaxique du guide sépare les balises de citation du texte ordinaire, décode leur JSON et affiche le numéro de citation avec l’URL de la source. Un message final <usage> indique l’utilisation des ressources et les coûts. Pour les requêtes bloquantes, les mêmes clés d’utilisation des ressources figurent dans les en-têtes de réponse.

Le schéma de réponse identifie les objets transmis en flux continu comme chat.completion.chunk et place le contenu dans choices[].delta.content. Pour les requêtes bloquantes, l’exemple du guide utilisant le SDK lit choices[0].message.content.

Termes associés

Questions fréquentes

Puis-je utiliser le SDK OpenAI avec cette API ?

Oui. L’exemple de Brave utilisant le SDK définit base_url sur https://api.search.brave.com/res/v1 et fournit une clé d’API Brave. Vous transmettez les paramètres propres à Brave, comme enable_citations, via extra_body.

Puis-je envoyer l’historique complet d’une conversation ?

La référence des requêtes prévoit exactement un message utilisateur. Vous devez construire vos requêtes en respectant cette contrainte d’entrée documentée.

Sources

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