API key de Brave Search: consíguela y haz tu primera búsqueda

API key de Brave Search

API key de Brave Search: planes, primera petición y agentes | We.Inc

Consigue una API key de Brave Search, consulta los planes a octubre de 2026, envía tu primera petición con la cabecera X-Subscription-Token y dale a un agente de IA una herramienta de búsqueda web.

Regístrate en la página de Brave Search API, elige un plan y crea una clave en el panel de la API. Envíala en la cabecera X-Subscription-Token a https://api.search.brave.com/res/v1/web/search con tu consulta en el parámetro q. A octubre de 2026, Search cuesta $5 por 1,000 peticiones e incluye $5 de crédito gratuito cada mes.

Planes de Brave Search API, a octubre de 2026 (brave.com/search/api)

Search
Answers
Enterprise

Precio
$5 por 1,000 peticiones
$4 por 1,000 peticiones más $5 por millón de tokens de entrada/salida
Contactar con Brave

Crédito gratuito
$5 cada mes
$5 cada mes
No indicado

Límite de peticiones
50 consultas por segundo
2 consultas por segundo
No indicado

Crea una petición abajo: escribe una consulta, elige cuántos resultados quieres y el nivel de búsqueda segura, y copia un comando curl o un fragmento con fetch. El campo de la clave nunca se rellena por ti; pon la tuya en lugar del marcador en tu servidor.

Abre la página de Brave Search API y selecciona Get API key para llegar al panel de la API.
Elige un plan. La documentación de Brave no detalla todas las pantallas, así que sigue las indicaciones del propio panel para la facturación y las claves.
Copia la clave y guárdala como variable de entorno en tu servidor, nunca en código front-end.
Haz la petición al endpoint de búsqueda web con la clave en la cabecera X-Subscription-Token y lee web.results de la respuesta JSON.

Cada resultado de web.results incluye title, url y description, que suele ser todo lo que necesita un agente.
count llega como máximo a 20 resultados por página y offset sube hasta 9, así que una consulta alcanza un número limitado de páginas.
safesearch es moderate por defecto. Ponlo en strict para una herramienta que puedan usar niños.
El crédito mensual de $5 cubre unas 1,000 peticiones de Search a la tarifa publicada, suficiente para pruebas y webs pequeñas.
Guarda en caché por tu lado las respuestas a preguntas repetidas; cada petición cuenta en la factura.

Preguntas frecuentes

¿La API de Brave Search es gratis?

No de forma ilimitada. A octubre de 2026, el plan Search cobra $5 por 1,000 peticiones e incluye $5 en créditos gratuitos cada mes, así que un uso ligero puede no costar nada.

¿Qué cabecera lleva la clave?

X-Subscription-Token. Los ejemplos de Brave la envían como cabecera en cada petición; la clave no va en la URL.

¿Puede un agente de IA usar Brave Search como herramienta de búsqueda web?

Sí. Envuelve la petición en una función que tu framework de agentes pueda ejecutar, devuelve los títulos, enlaces y descripciones y deja que el agente elija qué leer. Brave también ofrece un endpoint de contexto para LLM pensado para esto.

¿Qué es el plan Answers?

Answers devuelve respuestas redactadas en lugar de una lista de enlaces. Se cobra por cada 1,000 peticiones más por millón de tokens y tiene un límite más bajo, de 2 consultas por segundo.

¿Puedo usar la API desde el front-end de mi web?

No deberías, porque los visitantes podrían leer la clave en el código de la página. Úsala desde tu servidor o una función serverless y envía solo los resultados al navegador.

Endpoints que verás en la documentación

La búsqueda web está en /res/v1/web/search. Imágenes, vídeos y noticias tienen sus propias rutas bajo /res/v1/, y un endpoint de contexto para LLM en /res/v1/llm/context devuelve texto preparado para modelos de lenguaje.
Todos usan la misma clave y la misma cabecera, así que una clave sirve para cada endpoint que incluya tu plan.

Dale a un agente una herramienta de búsqueda

Una pequeña función que un agente puede ejecutar. Mantiene la clave en el servidor y devuelve solo lo que el agente necesita.

Función de herramienta webSearch

Regístrala en tu framework de agentes como una herramienta que recibe una cadena de consulta.

Generador de peticiones

Consulta de búsqueda

mejores ideas de web para panadería

Resultados (1 a 20)

Búsqueda segura

Desactivada

Moderada (predeterminada)

Estricta

fetch (en el servidor)

Coste mensual con el plan Search

Peticiones al mes

Unos ${v} después del crédito gratuito mensual, a la tarifa de octubre de 2026.

API key de Brave Search: consíguela y haz tu primera búsqueda