Por qué me importa una API de búsqueda
Construyo las integraciones de eesel, el código que trae artículos del centro de ayuda, macros y tickets a la IA. Casi todo ese trabajo se reduce a recuperación de información: encontrar el fragmento de texto correcto y mostrar de dónde salió. Un equipo de soporte de hardware, en una llamada de ventas de eesel, puso las citas en cada respuesta al principio de su lista y, en el mismo aliento, pidió que eesel rastreara un centro de ayuda protegido por inicio de sesión.
Ese par es más o menos la lente con la que leo este lanzamiento. Una API de búsqueda web barata resuelve la primera mitad del problema para la información pública. Para la segunda mitad no hace nada. Así que revisé la documentación y las reglas de facturación de DeepSeek, comparé el precio con otros ocho proveedores y leí lo que dijeron los desarrolladores en los primeros dos días. No tengo cifras propias de pruebas de rendimiento, así que cuando cito velocidad o calidad, viene de gente que lo midió.
¿Qué es la API de búsqueda de DeepSeek?
La API Search encuentra páginas web para una consulta y devuelve resultados estructurados. Su compañera, la API Fetch, recibe una URL y devuelve esa página en Markdown. La guía de Search y Fetch de DeepSeek describe ambas como API JSON directas que usan la misma clave bearer que el resto de la API de DeepSeek.
Salió el mismo día que DeepSeek V4.1 Flash 1017, la actualización de modelo que reseñé aparte. La entrada del registro de cambios dice que el motor detrás de la búsqueda web y de la API de DeepSeek ya atiende "hundreds of millions of search requests" al día, indexa "hundreds of billions of web pages" y filtra el spam de SEO y el contenido de baja calidad generado por IA. En pocas palabras, es la misma búsqueda que ya usaba el chatbot de DeepSeek, solo que ahora se vende por solicitud.
| API | Endpoint | Qué devuelve |
|---|---|---|
| Search | POST https://api.deepseek.com/v1/tools/search | Hasta 50 resultados con título, URL, fragmento, resumen, fecha y puntuaciones |
| Fetch | POST https://api.deepseek.com/v1/tools/fetch | El título de la página y su contenido en Markdown |
Cómo trabajan juntas Search y Fetch
Los dos endpoints encajan en el ciclo que ya ejecutan la mayoría de los agentes de investigación: buscar, elegir los enlaces prometedores, leerlos, responder. El modelo en sí nunca toca la web. Tu código (o un harness como Claude Code) hace las llamadas y mete los resultados en el contexto del modelo.
Una solicitud Search lleva cinco campos, según la referencia de la API Search:
| Campo | Valor por defecto | Qué hace |
|---|---|---|
query | obligatorio | De 1 a 128 caracteres, con operadores de búsqueda |
count | 10 | Número de resultados, de 1 a 50 |
ori_question | ninguno | La pregunta original del usuario, para ayudar a DeepSeek a entender la consulta |
localization | "" | Una dirección IP para localizar los resultados |
need_content | false | Devolver el contenido completo de la página en cada resultado |
La consulta admite los operadores que escribirías en un cuadro de búsqueda: site: y -site:, frases exactas entre comillas, lang:zh,en y fechas con after: / before:. El tope de 128 caracteres es ajustado, sobre todo para agentes que prefieren pegar la pregunta entera. ori_question es la solución: mantén la consulta corta y pasa la pregunta completa por separado.
Cada resultado trae además dos campos que no he visto empaquetados así en otras API. rerank_score va de 0 a 3, y DeepSeek dice que 1.5 o más cuenta como alta calidad. authority va de 0 a 4, y 3 o más indica una fuente muy autorizada. También hay un summary de 600 a 800 caracteres que DeepSeek dice que está "intended to be read by a model." Para un pipeline RAG, eso significa que puedes descartar páginas basura y pasar resúmenes al modelo antes de pagar por obtener nada. Una advertencia de un desarrollador temprano: en 60 resultados, encontró que rerank_score iba de 0.03 a 2.32 y "barely changes between different queries", lo que se parece más a una puntuación de calidad de página que a una de relevancia. Mi propio uso sería descartar páginas de baja calidad, no ordenar respuestas.
La API Fetch es más simple: envías una URL (hasta 8,192 caracteres) y recibes title y content. Si la página no se puede leer, porque el sitio la bloquea o no hay nada que extraer, recibes un 404. Un 403 significa que la propia política de seguridad de DeepSeek rechazó la solicitud. Conviene manejar ambos en el código, en lugar de dejar que tu agente reintente para siempre.
¿Cuánto cuesta la API de búsqueda de DeepSeek?
Search y Fetch se facturan por solicitud exitosa, no por tokens ni por número de resultados. Esta es la lista de precios completa de la página de precios de DeepSeek:
| API | Unidad | Precio |
|---|---|---|
| Search | Por cada 1,000 solicitudes exitosas | $0.75 |
| Fetch | Por cada 1,000 solicitudes exitosas | $0.75 |
La regla de facturación es generosa. Una solicitud cuenta solo si devuelve HTTP 200 y realmente produce algo: un array results no vacío en Search, contenido de página en Fetch. Los resultados vacíos, las solicitudes fallidas y los tiempos de espera agotados son gratis, y pedir 50 resultados cuesta lo mismo que pedir uno.
La otra mitad de la factura viene de que el modelo lea lo que trajiste. Esos tokens se facturan a los precios normales de Flash o a las tarifas de V4 Pro. Los precios fuera de hora punta son la mitad, y las horas punta son de 01:00 a 04:00 y de 06:00 a 10:00 UTC en días laborables:
| Modelo (por 1M de tokens) | Entrada, cache miss | Entrada, cache hit | Salida |
|---|---|---|---|
deepseek-flash, off-peak | $0.15 | $0.003 | $0.60 |
deepseek-flash, peak | $0.30 | $0.006 | $1.20 |
deepseek-v4-pro, off-peak | $0.66 | $0.022 | $1.98 |
deepseek-v4-pro, peak | $1.32 | $0.044 | $3.96 |
Una fecha merece un lugar en tu calendario. Cuando usas la API de DeepSeek mediante DeepSeek Harness, Claude Code o Codex, las búsquedas del lado del servidor del agente ya pasan por estos endpoints. La guía dice que esas llamadas son gratis por ahora y que la facturación por solicitud empieza a las 00:00 hora de Pekín del 1 de noviembre de 2026 (16:00 UTC del 31 de octubre). Si has dejado la búsqueda web activada en Claude Code porque no cuesta nada, eso cambia en menos de dos semanas.
Cómo se compara con otras API de búsqueda
Consulté la página de precios de cada proveedor el 19 de octubre de 2026. Las unidades no son las mismas entre proveedores, así que mira la segunda columna antes de comparar cifras.
| Proveedor | Unidad de facturación | Precio por 1,000 | ¿Se facturan también los tokens de resultados? | Nivel gratuito | Límite de velocidad |
|---|---|---|---|---|---|
| DeepSeek Search | Solicitud exitosa | $0.75 | No | Ninguno indicado | 5 por segundo |
| Perplexity Search | Solicitud (hasta 5 consultas) | $5 estándar, $1 Fast Search | No | Ninguno indicado | 50 por segundo |
| Exa | Solicitud (hasta 10 resultados) | $4 Instant, $7 Fast/Auto, $12 Deep | No, texto de página $1 por 1,000 páginas | $10 al mes | De 10 a 25 por segundo |
| Brave Search API | Solicitud | $5 | No | $5 de crédito al mes | 50 por segundo |
| Tavily | Crédito (búsqueda básica = 1) | $8 pago por uso, de $5 a $7.50 en planes | No | 1,000 créditos al mes | De 100 a 1,000 por minuto |
| Firecrawl search | Créditos (2 por 10 resultados) | Aprox. de $1.20 a $7.60 según el plan | No | 1,000 créditos al mes | Según el plan |
| OpenAI web search | Llamada a la herramienta | $10 | Sí | Ninguno indicado | Límites del modelo |
| Anthropic web search | Búsqueda | $10 | Sí | Ninguno indicado | Por organización |
| Gemini grounding | Consulta de búsqueda | $14 | No para resultados | 5,000 al mes | Límites del modelo |
Las cifras de Tavily y Firecrawl son cálculos míos a partir de sus tarifas de créditos, suponiendo profundidad básica y 10 resultados.
Tres cosas me llamaron la atención. Primero, DeepSeek está por debajo de todos los precios de lista de esta tabla, y los rivales más cercanos, a $1 o $1.20, son un nivel rápido o un plan de $599 al mes. Segundo, las filas de "más tokens" importan: OpenAI y Anthropic cobran $10 por mil búsquedas y luego facturan los resultados como tokens de entrada además, en modelos como GPT-5.6 y Claude (ver precios de la API de Anthropic) que cuestan mucho más por token que DeepSeek Flash. Tercero, el límite de velocidad de DeepSeek es el más bajo de la tabla, y por un margen amplio.
Si quieres cambiar de proveedor sin reescribir código, la Web Search API de Cloudflare pone tres de ellos detrás de un solo endpoint. Para investigación profunda de varios pasos en lugar de consultas sueltas, Exa Agent Ultra es un producto distinto a un precio distinto.
Si lo que necesitas sobre todo es convertir páginas a Markdown a gran escala, los precios de Firecrawl son la referencia para comparar Fetch.
Los 5 QPS son el número en el que hay que planificar
Search y Fetch permiten cada una 5 solicitudes por segundo por cuenta. Como el límite es de toda la cuenta, añadir más claves de API no lo sube. También es independiente de los límites de concurrencia de modelos de DeepSeek, y Fetch añade un tope por dominio. Todo lo que pase de la línea recibe HTTP 429.
Cinco por segundo suena a poco, pero haz la cuenta: son 432,000 búsquedas al día por endpoint, más volumen del que casi nadie necesita. Donde de verdad molesta es en las ráfagas. Un agente de investigación que lanza 20 búsquedas en paralelo, o 10 usuarios que usan tu app en el mismo segundo, superarán el límite aunque tu volumen mensual sea pequeño. Brave y Perplexity permiten 50 por segundo, así que aquí es donde el bajo precio de DeepSeek muestra su contrapartida.
La solución es aburrida y funciona, y es el mismo patrón que necesita cualquier integración de API para agentes de IA: poner una cola con un limitador token bucket delante de la API, reintentar los 429 con backoff y repartir los fetches entre dominios en lugar de martillar un solo sitio. La guía de errores de DeepSeek dice que hay que reintentar en 408, 429 y 5xx, recargar el saldo en 402 y no tocar los demás errores 4xx hasta que cambies la solicitud.
¿Cuánto cuesta realmente una tarea de agente?
Veamos un ejemplo con números. Supongamos que un agente de investigación ejecuta 2,000 tareas al mes, y cada tarea hace 4 búsquedas y obtiene 3 páginas. Son 8,000 búsquedas y 6,000 fetches, o $10.50 al mes en tarifas de DeepSeek. Las mismas 8,000 búsquedas costarían $40 en Brave, $64 en Tavily de pago por uso y $80 en OpenAI antes de sus cargos por tokens.
Ahora la parte que la gente suele saltarse. Esas 6,000 páginas obtenidas entran en el modelo. Si una página promedia 6,000 tokens (mi suposición, las páginas reales varían mucho), son 36 millones de tokens de entrada: $5.40 en Flash fuera de hora punta, $10.80 en Flash en hora punta o $23.76 en V4 Pro fuera de hora punta. En V4 Pro, las páginas que lees cuestan más que las búsquedas que las encontraron.
En trabajos pequeños, ocurre al revés. Un usuario de Reddit que registró una semana de trabajo de agentes encontró que un subagente de investigación hizo 85 búsquedas con solo $0.07 de trabajo del modelo. A $0.75 por mil, esas búsquedas costaron unos $0.06, casi tanto como el propio modelo. Así que, en llamadas baratas a Flash, la tarifa de búsqueda puede igualar la factura del modelo. Pon tus propios números abajo.
El estimador deja fuera los tokens de salida y los resúmenes de la búsqueda, así que tómalo como un mínimo. Dos palancas mueven la factura más que cualquier otra. La primera es need_content: true, que devuelve el texto de la página dentro de los resultados de búsqueda para que puedas saltarte los fetches separados. El creador de un motor de respuestas al estilo Perplexity dijo que llevó una pregunta "from 31s to 7s", con 15 resultados y unos 119,000 caracteres en una sola llamada facturable. Eso cambia tarifas de fetch por tokens, ya que 119,000 caracteres son unos 30,000 tokens que el modelo tiene que leer. La segunda palanca es el momento: ejecuta los trabajos por lotes fuera de hora punta, cuando cada token de DeepSeek cuesta la mitad. Y si Flash no es lo bastante listo para elegir buenas fuentes, compáralo con Kimi K3 o sube de nivel con mis notas de Flash vs Pro antes de pagar por más fetches.
Uso desde Claude Code, Codex y Harness
La mayoría se topará con esta API sin llamarla directamente. La guía de Claude Code de DeepSeek dice que la API "natively supports the Web Search feature in Claude Code." Cuando el modelo decide que una pregunta necesita la web, Claude Code llama a la herramienta Web Search y DeepSeek ejecuta la búsqueda de su lado.
La misma página detalla el costo: resumir los resultados de búsqueda requiere solicitudes adicionales al modelo, por lo que "additional model token costs will be incurred", y las búsquedas en sí se facturan a las tarifas de la API Search. Eso concuerda con lo que dije antes. En Claude Code, la tarifa de búsqueda es la línea pequeña de la factura. Si estás ajustando el gasto, mi guía de precios de Claude Code cubre el resto, y el artículo de variables de entorno muestra cómo apuntar Claude Code a otra API.
La restricción por modelo es fácil de pasar por alto. En la Responses API, la herramienta integrada web_search está "Supported with deepseek-v4-pro" y "Ignored with deepseek-flash." La integración con Codex es igual (mi artículo de precios de Codex cubre los planes propios de OpenAI): la búsqueda web solo funciona cuando Codex corre con deepseek-v4-pro, y el script de configuración de DeepSeek escribe web_search = "disabled" hasta que lo cambies a "live". Así que si pasaste Codex a Flash para ahorrar y la búsqueda dejó de funcionar sin avisar, esa es la razón. A los endpoints independientes no les importa qué modelo uses, porque tu código hace las llamadas.
DeepSeek Harness, la propia app de agentes de DeepSeek, es la tercera vía durante el periodo gratuito (mira las alternativas a Harness si no es tu herramienta). Su vista de trayectoria muestra cada llamada a herramienta de una sesión, que es la forma más fácil que conozco de ver cuántas búsquedas hace realmente un agente antes de empezar a pagarlas.
Qué dicen los desarrolladores
La primera reacción fue sobre el precio, y fue ruidosa. El hilo de Hacker News sobre el lanzamiento hizo la comparación que le importa a la gente:
"For comparison that's $5 with Brave Search API and $12 with Kagi API"
Los desarrolladores que ya habían construido sus propias herramientas de búsqueda, a menudo como servidor MCP, también quedaron impresionados:
"About a year ago I built my own search and fetch MCP tools for agents based on third-party scraping providers. It is about 15-20x more cost-effective than what OpenAI and Anthropic is offering with their integrated web search and fetch tools. Very impressive that DeepSeek has such a competitive offering today."
El dato más detallado vino de un usuario de Reddit que ejecutó 353 consultas y 196 fetches tanto en la nueva API como en la ruta de búsqueda anterior de DeepSeek, que facturaba por tokens. Sus números: el costo bajó de $0.64 a $0.41, y la latencia de búsqueda de 4.3 segundos a menos de 0.9 segundos. (La publicación dice que el propio modelo de DeepSeek la redactó a partir de los registros del usuario, y no comparó con Tavily, Exa ni Brave.) Su opinión sobre lo que importa, más allá de los fragmentos y fechas que ahora recibe en lugar de URL desnudas:
"The 2.4× is nice. The real win is that the price is now predictable"
Sobre la calidad, las opiniones son más mixtas. Un desarrollador que mantiene su propio benchmark de fetch no quedó impresionado:
"Ran a few quick tests on my web-fetch bench. As much as I like DeepSeek, its search and fetch aren't very good (is quite cheap tho). You'd probably be better off using free services like Jina directly, or if you're going paid, Parallel, Firecrawl, Tavily and Exa are all pretty good now."
Otro investigó qué hay detrás de la API:
"as expected, the typical "politically sensitive" search queries return 0 results"
El mismo comentario dice que el tráfico de fetch sale por Huawei Cloud en Hong Kong. Ninguno de los dos probadores dio cifras firmes, así que los tomaría como motivos para probar, no como veredictos. La pregunta abierta es la que intenta responder el widget de arriba:
"At $0.75 per 1000 requests, I want to know how many calls an agent makes in the background. Has anyone calculated the cost for typical research task?"
Y para los equipos que solo quieren empezar, se mencionó la ventaja poco glamurosa:
"I have been looking for Search API that will scale and no one is close to Deepseek's API search pricing. Deepseek also makes it easy to pay - just a credit card and you don't need to jump through any hoops to add money."
Dónde se queda corta
El precio es real, y los límites también. Antes de cambiar tu proveedor de búsqueda, revisa esto:
- Límite de velocidad. 5 solicitudes por segundo por cuenta es una décima parte de lo que permiten Brave y Perplexity. Bien para un agente, justo para un producto con mucho tráfico.
- Consultas cortas. 128 caracteres por consulta, así que las preguntas largas en lenguaje natural tienen que ir en
ori_question. - Ubicación de los datos. La política de privacidad de DeepSeek dice que los datos personales pueden almacenarse en servidores de la República Popular China, y enumera la mejora de sus modelos entre los usos de lo que introduce el usuario, con derecho de exclusión. Las consultas de búsqueda pueden contener datos de clientes, así que es una comprobación de cumplimiento, no una nota al pie.
- Sin condiciones de retención publicadas para la búsqueda. Brave describe la retención cero de datos por diseño, y Exa y Firecrawl la ofrecen en planes empresariales. No encontré una declaración equivalente para los endpoints de búsqueda de DeepSeek.
- Resultados filtrados. Un probador informó que las consultas políticamente sensibles devuelven cero resultados y que los fetches salen por Huawei Cloud en Hong Kong. Si tu agente investiga noticias, política o temas relacionados con China, espera huecos (y recuerda que los resultados vacíos al menos son gratis).
- Un índice que los externos no han probado a gran escala. DeepSeek dice que su motor atiende cientos de millones de búsquedas al día. Qué tan bien ordena los resultados de nicho en inglés frente a API respaldadas por Google o Brave es algo que debes probar con tus propias consultas, no aceptar de buena fe.
Nada de esto es un impedimento para un proyecto personal o una herramienta interna de investigación. Para cualquier cosa de cara al cliente, en cambio, se suma rápido.
¿Sirve para atención al cliente?
Aquí es donde yo iría más despacio. Una API de búsqueda web barata tienta a construir un bot de soporte que "simplemente lo busque". Para una porción pequeña de preguntas funciona: el calendario público de festivos de una empresa de paquetería, el registro de cambios de una herramienta de terceros que integra tu producto, una normativa que cambió la semana pasada.
Pero la mayoría de las respuestas de soporte no están en la web abierta, y por eso los motores de búsqueda con IA son malos para ellas. Están en tu centro de ayuda (a menudo detrás de un inicio de sesión, como el de aquel equipo de hardware), en tickets anteriores, en macros y en documentos internos. Ese es el trabajo de una base de conocimiento con IA, no de un motor de búsqueda. Una API de búsqueda web no alcanza nada de eso, y apuntarla a la web pública invita al bot a citar la documentación de un competidor o un post de foro de hace tres años como si fuera tu política. eesel aprendió una versión de esto por las malas: una respuesta que suena segura no es lo mismo que una respuesta correcta, y por eso cada despliegue de eesel se simula con tickets históricos antes de tocar a un cliente real.
Así que, para soporte, trataría la búsqueda web como una herramienta acotada que permites para fuentes públicas concretas, con filtros site:, no como la capa principal de conocimiento. La capa principal es tu propio contenido, con citas en cada respuesta. Si lo estás montando tú mismo, mis notas sobre MCP para atención al cliente cubren dónde encajan las herramientas web y dónde no.
Prueba eesel
La API de búsqueda de DeepSeek es infraestructura: una forma barata y rápida de que tu código encuentre y lea páginas públicas. Aun así tendrías que construir todo lo que hace que una IA sea segura para ponerla frente a los clientes. eesel es el empleado, uno de un equipo de compañeros de IA. Su compañero de IA para el helpdesk se conecta a Zendesk, Freshdesk, Gorgias y el resto, aprende de tu centro de ayuda, tus macros y tus tickets anteriores (incluidos los centros de ayuda detrás de un inicio de sesión), cita sus fuentes y se ejecuta contra cientos de tus tickets históricos antes de responder a nadie.
Si eres de los desarrolladores que leen documentación de API de búsqueda por diversión, probablemente querrás manejarlo desde una terminal. La CLI de eesel lo permite: npx @eesel/cli init chat-bubble --site <your-site> crea un espacio de trabajo gratuito de 7 días sin cuenta, eesel integrations connect zendesk conecta tu helpdesk, eesel instructions edita las reglas permanentes del compañero y eesel activity muestra qué hizo y por qué. Cada comando imprime JSON, las escrituras aceptan --dry-run y eesel mcp token convierte tu espacio de trabajo en un servidor MCP, para que Claude Code o Codex puedan gestionar tu compañero de soporte como gestionan tu repositorio. Si escribes contenido en lugar de responder tickets, el mismo equipo incluye un redactor de blogs con IA.
Empezar es gratis con 100 créditos y sin tarjeta. Prueba eesel con los tickets del mes pasado y mira qué habría respondido, y dónde habría citado tus documentos en lugar de la web abierta. Los planes están en la página de precios.
Preguntas frecuentes
¿Cuánto cuesta la API de búsqueda de DeepSeek?
La API de búsqueda de DeepSeek cuesta $0.75 por cada 1,000 solicitudes exitosas, y la API Fetch cuesta lo mismo. Una solicitud solo se cobra cuando devuelve HTTP 200 con resultados, así que las búsquedas vacías, los fallos y los tiempos de espera agotados son gratis. El desglose completo está en la sección de facturación de DeepSeek, y puedes compararlo con el costo de otros modelos en mi artículo sobre los precios de DeepSeek Flash.
¿Es gratis la búsqueda web de DeepSeek en Claude Code?
Por ahora, sí. Cuando ejecutas Claude Code, Codex o DeepSeek Harness con la API de DeepSeek, las búsquedas web del lado del servidor usan las API Search y Fetch gratis hasta las 00:00 hora de Pekín del 1 de noviembre de 2026. Después se cobran a la tarifa normal de la API de búsqueda de DeepSeek, más los tokens del modelo que se usen para leer los resultados.
¿Cuál es el límite de velocidad de la API de búsqueda de DeepSeek?
Search y Fetch permiten cada una 5 solicitudes por segundo por cuenta, sin importar cuántas claves de API uses. Fetch tiene además un límite por dominio. Las solicitudes que superan el límite reciben HTTP 429, así que los agentes de IA en paralelo necesitan una cola o un reintento con backoff.
¿Funciona la API de búsqueda de DeepSeek con DeepSeek Flash?
Los endpoints independientes de Search y Fetch funcionan con cualquier modelo, ya que tú los llamas y pasas los resultados. La herramienta integrada web_search de la Responses API y de Codex solo funciona con deepseek-v4-pro y se ignora con deepseek-flash. Mi comparación Flash vs Pro cubre el resto de las diferencias.
¿Cómo se compara la API de búsqueda de DeepSeek con Brave, Exa y Tavily?
En precio de lista es la más barata que encontré: $0.75 por cada 1,000 búsquedas frente a $5 de Brave, $4 de Exa Instant y $8 de la búsqueda básica de pago por uso de Tavily. A cambio, el límite de velocidad es menor (5 por segundo) y el índice es más nuevo para los desarrolladores externos. Si quieres elegir entre varios proveedores detrás de un solo endpoint, la Cloudflare Web Search API es otra opción.
¿Puedo usar la API de búsqueda de DeepSeek para un chatbot de atención al cliente?
Puedes, pero solo encuentra páginas web públicas. La mayoría de las respuestas de soporte viven en un centro de ayuda protegido por inicio de sesión, en tickets anteriores y en macros que ninguna búsqueda web alcanza. Un compañero de IA para el helpdesk como eesel aprende de esas fuentes privadas, y puedes probarlo con tickets anteriores antes de ponerlo en producción.
¿Qué devuelve la API Fetch de DeepSeek?
La API Fetch recibe una URL y devuelve el título de la página más el contenido en Markdown. Cuesta lo mismo que la API de búsqueda de DeepSeek, $0.75 por cada 1,000 solicitudes exitosas, y las páginas que no puede leer devuelven un 404 que no se cobra. Cumple el mismo papel que un scraper como Firecrawl, sin el rastreo ni las opciones de formato.