DeepSeek Search API: precio, límites y cobro en Claude Code

DeepSeek Search API cuesta 0,75 $ por cada 1.000 solicitudes exitosas, y Fetch, la API hermana que convierte una página en Markdown, cuesta lo mismo. A 30 de octubre de 2026, la guía de Search y Fetch de DeepSeek cobra por solicitud, no por tokens ni por número de resultados: pedir 50 resultados cuesta igual que pedir uno, y una búsqueda sin resultados, una solicitud fallida o un tiempo de espera agotado no se cobran. Las llamadas directas no tienen cuota gratuita; el importe se descuenta de tu saldo de la API.

Lo que cambia es la búsqueda dentro de los agentes. Si usas Claude Code, Codex o DeepSeek Harness con una clave de DeepSeek, las búsquedas que esas herramientas lanzan en el servidor ya pasan por esta API y han sido gratis desde el 17 de octubre; dejan de serlo el sábado 31 de octubre de 2026 a las 17:00 en la España peninsular (16:00 UTC). Desde ese momento cada búsqueda paga la tarifa y, además, los tokens que el modelo gasta en leer los resultados: con deepseek-flash en hora valle sale por unos 0,002 $ si los resultados ocupan 6.000 tokens, y con deepseek-v4-pro en hora punta, por unos 0,011 $.

Si no quieres ese cargo, en Claude Code añade WebSearch a la lista deny de tus permisos, o a ask si prefieres aprobar cada búsqueda, y en Codex deja web_search = "disabled" en ~/.codex/config.toml. Antes de llevarla a producción, ten en cuenta lo que el precio no dice: la búsqueda la hace el buscador propio de DeepSeek, y usuarios de Hacker News informan de que eso abre una vía de datos hacia China aunque tu modelo corra en la UE y de que las consultas políticamente sensibles devuelven cero resultados. El límite actual es de 100 búsquedas y 25 Fetch por segundo por cuenta, no las 5 por segundo del día del lanzamiento.

Qué se cobra en DeepSeek Search y Fetch: solo la solicitud con resultado

Una solicitud es cobrable solo cuando devuelve HTTP 200 y además produce un resultado: en Search, una lista results que no esté vacía; en Fetch, el contenido de la página. Así lo explica la sección de facturación de la guía, y la página de precios de la API de DeepSeek lo resume a 30 de octubre de 2026 diciendo que Search y Fetch son API independientes que se cobran por solicitud. El anuncio del 17 de octubre hablaba de 0,75 $ «per 1,000 calls», pero lo que se aplica al facturar es la regla de solicitudes exitosas.

De ahí salen dos consecuencias prácticas. La primera: la solicitud no tiene campo de paginación ni de desplazamiento, así que repetir la misma consulta te devuelve otra vez los primeros resultados y cada repetición se cobra; si necesitas más resultados, pide los que te hagan falta de una vez, hasta count: 50. La segunda: el cobro sale del saldo de la cuenta, y si tienes saldo concedido además del recargado, DeepSeek gasta primero el concedido. La versión china de la página de precios fija 5 yuanes por cada 1.000 solicitudes; es una tarifa propia, no una conversión del precio en dólares.

Cobro en Claude Code y Codex desde el 31 de octubre, 17:00 CET

DeepSeek fija el inicio del cobro a las 00:00 del 1 de noviembre de 2026, hora de Pekín, que en España corresponde al sábado 31 de octubre de 2026 a las 17:00 en la península y Baleares, y a las 16:00 en Canarias (16:00 UTC). España volvió al horario de invierno el 25 de octubre, así que la diferencia con UTC ya es de una hora y no de dos. Hasta ese momento, las llamadas a Search y Fetch que DeepSeek Harness, Claude Code y Codex hacen como herramientas del servidor no se cobran; a partir de ahí pagan por solicitud, con la misma tarifa que las llamadas directas. El cobro empieza solo, sin que tengas que activar nada, así que una sesión de agente que dejes trabajando esa tarde empezará a generar cargos de búsqueda a mitad de tarea.

Cuánto cuesta una búsqueda en Claude Code con DeepSeek: de 0,002 $ a 0,011 $

Una búsqueda dentro de Claude Code cuesta la tarifa de Search, 0,00075 $, más los tokens con los que el modelo lee y resume los resultados; la guía de DeepSeek para usar Claude Code advierte de los dos cargos. DeepSeek no publica cuántos tokens añade una búsqueda, así que el cálculo siguiente, hecho el 30 de octubre de 2026 con los precios de lista de ese día, supone 6.000 tokens de entrada sin caché y 500 de salida por búsqueda. Como referencia, Anthropic estima unos 2.500 tokens para una página web media de 10 kB.

Para rehacer la cuenta con tus cifras: con deepseek-flash en valle, 6.000 × 0,15 $ / 1.000.000 + 500 × 0,60 $ / 1.000.000 = 0,0012 $ de tokens, y al sumar la búsqueda quedan 0,00195 $. En punta los tokens de flash cuestan el doble (0,30 $ y 1,20 $ por millón), y deepseek-v4-pro cobra 0,66 $ y 1,98 $ por millón en valle, el doble en punta. Con flash, la tarifa de búsqueda supone el 38 % del total en valle y el 24 % en punta; con v4-pro mandan los tokens. Si los resultados ocupan menos o el modelo acierta en caché, el coste baja.

Qué fila te toca depende del modelo que recibe DeepSeek. Con la configuración que propone DeepSeek, todas las variables de modelo de Claude Code apuntan a deepseek-flash. Si a DeepSeek le llega un nombre que empieza por claude-opus, por ejemplo porque no has definido ANTHROPIC_DEFAULT_OPUS_MODEL, lo atiende deepseek-v4-pro y lo cobra a precio de V4 Pro; los nombres claude-sonnet y claude-haiku van a deepseek-flash. La hora punta en la España peninsular son los laborables de 02:00 a 05:00 y de 07:00 a 11:00 CET, salvo festivos chinos; el detalle está en Precio de la API de DeepSeek en hora punta y valle desde España, y la conexión paso a paso, en Claude Code con OpenRouter y DeepSeek: rutas, configuración y primeros errores.

Lo que nadie ha publicado es cuántas búsquedas cobradas genera una sola llamada a WebSearch. Cuando Claude Code usa el backend de Anthropic, su documentación dice que una llamada puede lanzar hasta ocho búsquedas internas y devuelve solo títulos y URL; leer una página es otra llamada, a WebFetch, con su propia petición al modelo. DeepSeek no aclara si con su API ocurre lo mismo ni si WebFetch pasa por su Fetch. Un usuario de Reddit citado por eesel.ai en su artículo sobre DeepSeek Search API contó que un subagente de investigación hizo 85 búsquedas con 0,07 $ de trabajo del modelo. Por eso, a partir del 31 de octubre, compara las llamadas a WebSearch de una sesión con las solicitudes de Search que aparecen en los registros de uso de DeepSeek antes de multiplicar la tabla por tu número de búsquedas.

Si conectas Claude Code a través de laozhang.ai en lugar del endpoint de DeepSeek, WebSearch no está disponible en esa ruta y la búsqueda de DeepSeek no entra en juego; la búsqueda web propia de laozhang.ai es para modelos GPT y Grok (0,01 $ por búsqueda) y Gemini (0,014 $ por búsqueda), más los tokens de los resultados.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

Cómo evitar cargos de búsqueda en Claude Code y Codex

Claude Code y Codex tienen sus propios interruptores y funcionan igual con DeepSeek que con cualquier otro backend: en Claude Code son reglas de permiso y en Codex, la clave web_search. En el modo Manual, según la documentación de permisos de Claude Code, WebSearch ya pide aprobación antes de cada búsqueda, salvo que alguna vez respondieras «Yes, and don't ask again», que la deja permitida para siempre en ese repositorio. Revisa los ajustes en este orden:

1. Abre .claude/settings.local.json en la raíz del repositorio y borra la regla que permite WebSearch si la hay; es donde Claude Code guarda las aprobaciones permanentes.
2. Para que pregunte siempre, añade "ask": ["WebSearch"] dentro de "permissions" en ~/.claude/settings.json (todos tus proyectos) o en .claude/settings.json del proyecto.
3. Para quitar la búsqueda del todo, usa "deny": ["WebSearch"] en el mismo sitio. Una regla con solo el nombre de la herramienta la retira del contexto de Claude, que ni siquiera la ve; para una sola sesión, arranca con claude --disallowedTools WebSearch.
4. Si también quieres cortar la lectura de páginas, define CLAUDE_CODE_DISABLE_WEB_FETCH=1 (Claude Code v2.1.285 o posterior) o añade WebFetch a deny.
5. En Codex, abre ~/.codex/config.toml y comprueba que dice web_search = "disabled", que es lo que escribe el script de instalación de DeepSeek. Si lo cambiaste a "live", vuelve a "disabled" y reinicia Codex.
6. Después del 31 de octubre, mira en los registros de uso de tu cuenta de DeepSeek cuántas solicitudes de Search se han cobrado.

{
  "permissions": {
    "deny": ["WebSearch"]
  }
}

En Codex y en la Responses API de DeepSeek, web_search solo funciona con deepseek-v4-pro: la guía de DeepSeek para Codex y la de la Responses API indican que con deepseek-flash la herramienta se ignora. Lo mismo vale para el nombre antiguo deepseek-v4-flash, que hoy atiende el mismo modelo, V4.1-Flash-1017. Si usas Codex con flash no hay cargo de búsqueda posible; activarla implica cambiar a model = "deepseek-v4-pro" con web_search = "live", y pagar tanto la búsqueda como los tokens de V4 Pro.

Cuánto pagarás al mes con la API directa: fórmula y cuatro ejemplos

Si llamas a Search y Fetch desde tu propia aplicación, la factura mensual es (búsquedas con resultados + Fetch con contenido) × 0,75 $ / 1.000, y los tokens que tu modelo gaste en leer los resultados se pagan aparte, a la tarifa del modelo. La tabla aplica esa fórmula a cuatro tipos de aplicación con los precios de lista a 30 de octubre de 2026; es un cálculo, no tráfico medido.

El caso que más se dispara es la monitorización, porque multiplica consultas por frecuencia: 500 × 24 × 30 = 360.000 solicitudes. Ahí ahorra más reducir la frecuencia o agrupar consultas que pedir menos resultados, ya que count no cambia el precio.

¿Más barata que Brave, Tavily o Exa? 22,50 $ frente a 110 $ al mes

En precio de lista, sí, y con mucha diferencia: para 30.000 búsquedas al mes (1.000 al día), DeepSeek sale por 22,50 $ y la siguiente opción, Exa, por 110 $, con los precios publicados a 30 de octubre de 2026. El cálculo descuenta la parte gratuita mensual de cada servicio y elige un volumen por debajo del tope diario de Gemini.

La comparación no es del todo pareja. Las tarifas de la API de OpenAI, los precios de Claude y los precios de la API de Gemini corresponden a herramientas integradas en el modelo, que además cobran los tokens de los resultados; DeepSeek, Brave, Exa y Tavily son API de búsqueda en bruto, y leer lo que devuelven te cuesta los tokens de tu propio modelo. Tavily tiene planes mensuales con el crédito más barato (de 0,005 $ a 0,0075 $), y la página de Brave muestra a la vez «hasta 20 $ en llamadas gratis» en un aviso y 5 $ en la tarjeta del plan; el cálculo usa 5 $. Para quien usa Claude Code, la comparación que importa es la de la búsqueda web de Anthropic, y ninguna de estas cifras dice nada de la calidad, que se trata más abajo.

Límites de DeepSeek Search API: 100 búsquedas y 25 Fetch por segundo

A 30 de octubre de 2026, cada cuenta puede hacer 100 solicitudes por segundo a Search y 25 a Fetch, dos límites independientes que se cuentan por cuenta, uses la clave que uses, y que no comparten cupo con la concurrencia de los modelos. Por encima, la API devuelve HTTP 429, que no se cobra. Fetch tiene además un límite por dominio de destino cuyo valor DeepSeek no publica, también con 429.

La cifra de 5 solicitudes por segundo que todavía circula es la del lanzamiento. La copia de la guía guardada en Internet Archive el 17 de octubre de 2026 indicaba 5 para Search y 5 para Fetch, y la del 20 de octubre de 2026 ya muestra 100 y 25. DeepSeek no anunció el cambio, que se produjo entre el 19 y el 20 de octubre. En la práctica, 100 por segundo equivalen a un techo de 8.640.000 búsquedas al día, y 25 por segundo, a 2.160.000 Fetch.

Cómo llamar a /v1/tools/search y por qué un 401 no confirma la URL

Search y Fetch son endpoints JSON normales que usan la misma clave que la API de chat, en la cabecera Authorization: Bearer. Search exige query (de 1 a 128 caracteres, con operadores como site:, -site:, "frase exacta", lang:es,en, after: y before:) y acepta count de 1 a 50, 10 por defecto; need_content: true añade el texto de cada página al resultado. Fetch solo necesita url, HTTP o HTTPS de hasta 8.192 caracteres, y devuelve el título y el contenido en Markdown.

curl https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "DeepSeek V4 site:github.com lang:en after:2025", "count": 10}'

curl https://api.deepseek.com/v1/tools/fetch \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/"}'

Un 401 solo te dice que la clave no vale. El 29 de octubre de 2026 a las 17:24 CET (16:24 UTC), ocho solicitudes enviadas desde un Mac sin clave o con una clave falsa recibieron todas un 401 Authentication Fails en algo más de un segundo, incluidas una ruta equivocada (POST /v1/search), un GET al endpoint de búsqueda, un JSON roto, una búsqueda con count: 60 y una llamada al endpoint de formato Anthropic con la herramienta web_search. DeepSeek comprueba la clave antes que la ruta, el método y el cuerpo, así que el 400 documentado para count fuera de rango solo aparece con una clave válida. Esas pruebas no generaron cobro posible y no incluyen ninguna búsqueda real, de modo que la calidad y la latencia de los resultados no salen de ellas.

Con una clave válida, la guía de errores de Search y Fetch separa qué reintentar: 408, 429 y los 5xx se pueden repetir tras una espera; 402 significa saldo insuficiente y hay que recargar antes; el resto de 4xx no se arregla repitiendo la misma solicitud.

Calidad y filtrado de DeepSeek Search: qué han contado otros usuarios

No hay mediciones públicas con cifras sobre la calidad de DeepSeek Search; lo que existe son informes de usuarios de los primeros días. En el hilo de Hacker News sobre el lanzamiento de DeepSeek Search y Fetch, del 18 de octubre de 2026, un usuario contó que las consultas «políticamente sensibles» típicas devuelven 0 resultados y que Fetch sale desde Huawei Cloud en Hong Kong con un navegador configurado en chino; otro, tras unas pruebas rápidas en su banco de pruebas de Fetch, concluyó que Search y Fetch «no son muy buenos», aunque sí baratos, y propuso Jina, Tavily o Exa. Como las búsquedas vacías no se cobran, una consulta filtrada no te cuesta nada, pero tampoco te devuelve nada.

En el otro lado está el usuario de Reddit que cita eesel.ai: 353 búsquedas y 196 Fetch le costaron 0,41 $ con la API nueva frente a 0,64 $ con la vía anterior de DeepSeek, que cobraba por tokens, y la latencia de búsqueda bajó de 4,3 segundos a menos de 0,9. Es un solo usuario, sin comparación con Brave, Tavily ni Exa, y la publicación la redactó el modelo de DeepSeek a partir de sus registros.

Con eso, para casi cualquier agente o RAG compensa probarla si el precio manda, y conviene descartarla en tres casos. Si tus datos o los de tus clientes no pueden salir hacia China, porque usuarios de Hacker News señalan la búsqueda como una vía de datos hacia China aunque el modelo corra en la UE, y otro vio salir las peticiones de Fetch desde Huawei Cloud en Hong Kong. Si tu aplicación necesita noticias o temas políticos y un resultado vacío sería un fallo, no un ahorro. Y si vas a leer muchas páginas de un mismo sitio o necesitas más de 25 Fetch por segundo, porque el límite por dominio no está publicado.