API Key di Brave Search: Ottienila e Fai la Prima Ricerca

API key di Brave Search

API Key di Brave Search: Piani, Prima Richiesta e Uso con gli Agenti | We.Inc

Ottieni una API key di Brave Search, vedi i piani a ottobre 2026, invia la tua prima richiesta con l'header X-Subscription-Token e dai a un agente AI uno strumento di ricerca web.

Registrati sulla pagina della Brave Search API, scegli un piano e crea una chiave nella API dashboard. Inviala nell'header X-Subscription-Token a https://api.search.brave.com/res/v1/web/search con la tua query nel parametro q. A ottobre 2026, Search costa $5 ogni 1,000 richieste e include $5 di credito gratuito ogni mese.

Piani della Brave Search API, a ottobre 2026 (brave.com/search/api)

Search
Answers
Enterprise

Prezzo
$5 ogni 1,000 richieste
$4 ogni 1,000 richieste più $5 per milione di token in input/output
Contatta Brave

Credito gratuito
$5 ogni mese
$5 ogni mese
Non indicato

Rate limit
50 query al secondo
2 query al secondo
Non indicato

Crea una richiesta qui sotto: scrivi una query, scegli quanti risultati e il livello di ricerca sicura, e copia un comando curl o uno snippet fetch. Il campo della chiave non viene mai compilato per te; incolla la tua al posto del segnaposto sul tuo server.

Apri la pagina della Brave Search API e seleziona Get API key per arrivare alla API dashboard.
Scegli un piano. La documentazione di Brave non descrive ogni schermata, quindi segui le indicazioni della dashboard per fatturazione e chiavi.
Copia la chiave e salvala come variabile d'ambiente sul tuo server, mai nel codice front-end.
Chiama l'endpoint di ricerca web con la chiave nell'header X-Subscription-Token e leggi web.results dalla risposta JSON.

Ogni risultato in web.results contiene title, url e description, che di solito è tutto ciò che serve a un agente.
count arriva al massimo a 20 risultati per pagina, e offset arriva fino a 9, quindi una query raggiunge un numero limitato di pagine.
safesearch è moderate di default. Impostalo su strict per uno strumento che potrebbero usare dei bambini.
Il credito mensile di $5 copre circa 1,000 richieste Search alla tariffa pubblicata, abbastanza per i test e per i siti piccoli.
Metti in cache dalla tua parte le risposte alle domande ripetute; ogni richiesta pesa sulla fattura.

Domande frequenti

La Brave Search API è gratuita?

Non in modo illimitato. A ottobre 2026, il piano Search addebita $5 ogni 1,000 richieste e include $5 di crediti gratuiti ogni mese, quindi un uso leggero può non costare nulla.

Quale header contiene la chiave?

X-Subscription-Token. Gli esempi di Brave lo inviano come header della richiesta in ogni chiamata; nell'URL non c'è nessuna chiave.

Un agente AI può usare Brave Search come strumento di ricerca web?

Sì. Inserisci la richiesta in una funzione che il tuo framework per agenti può chiamare, restituisci titoli, link e descrizioni, e lascia che l'agente scelga cosa leggere. Brave offre anche un endpoint LLM context pensato per questo.

Cos'è il piano Answers?

Answers restituisce risposte scritte invece di un elenco di link. Ha un prezzo ogni 1,000 richieste più un prezzo per milione di token, e un rate limit più basso di 2 query al secondo.

Posso chiamare l'API dal front end del mio sito?

Non dovresti, perché i visitatori potrebbero leggere la chiave nel codice della pagina. Chiamala dal tuo server o da una funzione serverless e invia al browser solo i risultati.

Gli endpoint che vedrai nella documentazione

La ricerca web si trova su /res/v1/web/search. Immagini, video e notizie hanno i loro percorsi sotto /res/v1/, e un endpoint LLM context su /res/v1/llm/context restituisce testo strutturato per i modelli linguistici.
Usano tutti la stessa chiave e lo stesso header, quindi una sola chiave copre ogni endpoint incluso nel tuo piano.

Dare a un agente uno strumento di ricerca

Una piccola funzione che un agente può chiamare. Tiene la chiave sul server e restituisce solo ciò che serve all'agente.

Funzione tool webSearch

Registrala nel tuo framework per agenti come tool che accetta una stringa di query.

Generatore di richieste

Query di ricerca

idee per il sito di una panetteria

Risultati (da 1 a 20)

Ricerca sicura

Disattivata

Moderata (predefinita)

Rigorosa

fetch (lato server)

Costo mensile con il piano Search

Richieste al mese

Circa ${v} dopo il credito gratuito mensile, alla tariffa di ottobre 2026.

Copia

Copiato

Inizia gratis · Nessuna carta di credito richiesta

Correlati: Guide

Prodotto

Per chi è

Funzionalità

Risorse

Azienda

Mappa del sito