Clé API Brave Search : l'obtenir et faire votre première recherche

Clé API Brave Search

Clé API Brave Search : forfaits, première requête et agents | We.Inc

Obtenez une clé API Brave Search, consultez les forfaits en octobre 2026, envoyez votre première requête avec l'en-tête X-Subscription-Token et donnez à un agent IA un outil de recherche web.

Inscrivez-vous sur la page Brave Search API, choisissez un forfait et créez une clé dans le tableau de bord de l'API. Envoyez-la dans l'en-tête X-Subscription-Token vers https://api.search.brave.com/res/v1/web/search avec votre requête dans le paramètre q. En octobre 2026, Search coûte $5 pour 1,000 requêtes et inclut $5 de crédit gratuit chaque mois.

Les forfaits Brave Search API, en octobre 2026 (brave.com/search/api)

Search
Answers
Enterprise

Prix
$5 pour 1,000 requêtes
$4 pour 1,000 requêtes plus $5 par million de tokens en entrée/sortie
Contacter Brave

Crédit gratuit
$5 chaque mois
$5 chaque mois
Non indiqué

Limite de débit
50 requêtes par seconde
2 requêtes par seconde
Non indiqué

Construisez une requête ci-dessous : saisissez une recherche, choisissez le nombre de résultats et le niveau de filtrage SafeSearch, puis copiez une commande curl ou un snippet fetch. Le champ de la clé n'est jamais rempli à votre place ; collez la vôtre à la place de la valeur d'exemple sur votre serveur.

Ouvrez la page Brave Search API et sélectionnez Get API key pour accéder au tableau de bord de l'API.
Choisissez un forfait. La documentation de Brave ne détaille pas chaque écran, suivez donc les indications du tableau de bord pour la facturation et les clés.
Copiez la clé et stockez-la dans une variable d'environnement sur votre serveur, jamais dans du code front-end.
Appelez l'endpoint de recherche web avec la clé dans l'en-tête X-Subscription-Token et lisez web.results dans la réponse JSON.

Chaque résultat de web.results contient un title, une url et une description, c'est généralement tout ce dont un agent a besoin.
count plafonne à 20 résultats par page et offset monte jusqu'à 9, donc une requête n'atteint qu'un nombre limité de pages.
safesearch vaut moderate par défaut. Réglez-le sur strict pour un outil que des enfants pourraient utiliser.
Le crédit mensuel de $5 couvre environ 1,000 requêtes Search au tarif publié, assez pour les tests et les petits sites.
Mettez en cache de votre côté les réponses aux questions répétées ; chaque requête compte dans la facture.

Questions fréquentes

L'API Brave Search est-elle gratuite ?

Pas de façon illimitée. En octobre 2026, le forfait Search facture $5 pour 1,000 requêtes et inclut $5 de crédits gratuits chaque mois, donc un usage léger peut ne rien coûter.

Quel en-tête transporte la clé ?

X-Subscription-Token. Les exemples de Brave l'envoient comme en-tête de requête à chaque appel ; il n'y a pas de clé dans l'URL.

Un agent IA peut-il utiliser Brave Search comme outil de recherche web ?

Oui. Encapsulez la requête dans une fonction que votre framework d'agents peut appeler, renvoyez les titres, liens et descriptions, et laissez l'agent choisir quoi lire. Brave propose aussi un endpoint de contexte LLM conçu pour cela.

Qu'est-ce que le forfait Answers ?

Answers renvoie des réponses rédigées au lieu d'une liste de liens. Il est facturé pour 1,000 requêtes plus par million de tokens et a une limite de débit plus basse de 2 requêtes par seconde.

Puis-je appeler l'API depuis le front-end de mon site ?

Mieux vaut ne pas le faire, car les visiteurs pourraient lire la clé dans le code de la page. Appelez-la depuis votre serveur ou une fonction serverless et n'envoyez que les résultats au navigateur.

Les endpoints que vous verrez dans la documentation

La recherche web se trouve sur /res/v1/web/search. Les images, les vidéos et les actualités ont leurs propres chemins sous /res/v1/, et un endpoint de contexte LLM sur /res/v1/llm/context renvoie du texte mis en forme pour les modèles de langage.
Tous utilisent la même clé et le même en-tête, donc une seule clé couvre chaque endpoint inclus dans votre forfait.

Donner un outil de recherche à un agent

Une petite fonction qu'un agent peut appeler. Elle garde la clé sur le serveur et ne renvoie que ce dont l'agent a besoin.

Fonction d'outil webSearch

Enregistrez-la dans votre framework d'agents comme outil qui prend une chaîne de recherche.

Générateur de requêtes

Requête de recherche

meilleures idées de site web pour boulangerie

Résultats (1 à 20)

SafeSearch

Désactivé

Modéré (par défaut)

Strict

fetch (côté serveur)

Coût mensuel avec le forfait Search

Requêtes par mois

Environ ${v} après le crédit gratuit mensuel, au tarif d'octobre 2026.

Copier

Copié

Commencer gratuitement · Sans carte bancaire

Clé API Brave Search : l'obtenir et faire votre première recherche