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.
Copiar
Copiado
Crea tu sitio gratis · Gratis para crear, sin tarjeta
Relacionado: Guías
- Diseño web brutalista
- Webs con blog
- Asuntos de correo profesional que se abren
- Caddy vs nginx
- Ejemplos de llamadas a la acción
- Crear la web de un concesionario de coches
- Ejemplos de páginas de empleo
- Qué hace una CDN, explicado de forma sencilla
Producto
Para quién es
- Para agencias
- Para freelancers
- Para proveedores de hosting
- Para plataformas SaaS
- Para startups
- Servicios financieros
- Soluciones para salud
Funciones
Recursos
- Blog
- Centro de Ayuda
- Herramientas gratuitas para empresas
- Free UI Components
- Plantillas
- Colecciones de plantillas
- Ejemplos de webs
- Guías
- Comparativas
- Alternativas
- Los mejores
- Reseñas
- Guías de precios
- Casos de uso
- Glosario y guías
- Integraciones
- Desarrolladores
- Benchmark
- Windows App