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
- Web design brutalista
- Siti Aziendali con Blog
- Oggetti per Email di Lavoro che Vengono Aperte
- Caddy vs nginx
- Esempi di call to action
- Crea un Sito Web per Concessionaria Auto
- Esempi di pagine Lavora con noi
- Cosa Fa una CDN, Spiegato in Modo Semplice
Prodotto
Per chi è
- Per le agenzie
- Per i freelance
- Per i provider di hosting
- Per le piattaforme SaaS
- Per le startup
- Servizi finanziari
- Soluzioni per la sanità
Funzionalità
Risorse
- Blog
- Centro assistenza
- Strumenti gratuiti per le aziende
- Free UI Components
- Template
- Raccolte di template
- Esempi di siti
- Guide
- Confronti
- Alternative
- I migliori
- Recensioni
- Guide ai prezzi
- Casi d'uso
- Glossario e guide
- Integrazioni
- Sviluppatori
- Benchmark
- Windows App