Respuesta rápida: La API de Search de DeepSeek es gratis solo dentro de tres herramientas de programación, y solo hasta el 31 de octubre de 2026 a las 16:00 UTC. Las llamadas de Search y Fetch que Claude Code, Codex o DeepSeek Harness hacen del lado del servidor no cuestan nada hasta entonces. Después de eso, y para cada llamada directa a los endpoints, pagas $0.75 por cada 1,000 solicitudes exitosas por endpoint. Las llamadas fallidas, los resultados vacíos y los tiempos de espera agotados nunca se cobran.
DeepSeek abrió sus API de Search y Fetch a todo el mundo el 17 de octubre de 2026, junto con el lanzamiento de DeepSeek-V4.1-Flash-1017. Le dan a un agente resultados web actualizados para una consulta y una copia limpia en Markdown de cualquier página. Esta guía cubre qué es gratis, cuánto cuesta después de la ventana, los límites de velocidad, una primera solicitud y cómo probar ambos endpoints con Apidog CLI.
Todos los datos a continuación provienen de la guía de Search & Fetch de DeepSeek y de la página de precios, consultadas el 28 de octubre de 2026.
¿Es gratis la API de Search de DeepSeek?
Sí, con dos límites: desde dónde la llamas y cuándo. La documentación de DeepSeek dice que las llamadas de Search y Fetch del lado del servidor realizadas a través de DeepSeek Harness, Claude Code o Codex son "actualmente gratuitas". La facturación por solicitud para esas llamadas comienza a las 00:00 del 1 de noviembre de 2026 en UTC+8, que es las 16:00 UTC del 31 de octubre de 2026.
| Ruta | Costo de Search y Fetch antes del 31 de oct, 16:00 UTC | Después |
|---|---|---|
| Claude Code con una clave de API de DeepSeek | $0 | $0.75 / 1,000 llamadas exitosas |
| Codex con una clave de API de DeepSeek | $0 | $0.75 / 1,000 llamadas exitosas |
| DeepSeek Harness | $0 | $0.75 / 1,000 llamadas exitosas |
Llamada directa POST a /v1/tools/search o /v1/tools/fetch |
$0.75 / 1,000 llamadas exitosas | $0.75 / 1,000 llamadas exitosas |
Dos advertencias impiden que esta sea una ruta realmente de coste cero:
- Aún necesitas una clave de API de DeepSeek con fondos. La ventana gratuita cubre las llamadas de búsqueda, no el modelo. La página de integración con Claude Code de DeepSeek dice que resumir los resultados de búsqueda usa solicitudes adicionales al LLM, y esos tokens se facturan a los precios normales del modelo.
- La ventana cubre solo las llamadas a herramientas del lado del servidor. La documentación la limita a esas tres herramientas. Si tu propio código llama a los endpoints, pagas desde la primera solicitud exitosa.
Si buscas un modelo DeepSeek gratis en lugar de búsqueda gratuita, nuestra guía sobre si DeepSeek es gratis enumera todas las rutas, y clave de API de DeepSeek gratis cubre la clave en sí.
Qué hacen las API de Search y Fetch de DeepSeek
La API de Search de DeepSeek recibe una consulta y devuelve resultados web estructurados: título, URL, fragmento, un resumen más largo orientado al modelo, un campo opcional de contenido de página completa, una puntuación de relevancia y una puntuación de autoridad. La API de Fetch de DeepSeek recibe una URL y devuelve el título de esa página y su contenido en Markdown. Juntas le dan a un agente búsqueda y lectura en dos llamadas.
Un agente de investigación normalmente busca una vez y luego obtiene dos o tres páginas, y cada una es una llamada facturable por separado después de la ventana. Search admite operadores: site:, -site:, "phrase", -term, lang:en,ja, after: y before:.
Puedes compararlo con otras opciones en nuestra recopilación de API de búsqueda web gratuitas, la API de búsqueda web de Claude y la API de Search de Perplexity.
Precios de la API de Search de DeepSeek después de la ventana gratuita
Una vez que se cierre la ventana, ambos endpoints facturan de la misma manera:
| API de Search | API de Fetch | |
|---|---|---|
| Precio | $0.75 por cada 1,000 solicitudes exitosas | $0.75 por cada 1,000 solicitudes exitosas |
| Por llamada | $0.00075 | $0.00075 |
| Se factura cuando | HTTP 200 con un array results no vacío |
HTTP 200 con contenido de la página |
| No se factura | Solicitudes fallidas, resultados vacíos, tiempos de espera agotados | Solicitudes fallidas, tiempos de espera agotados |
¿count cambia el precio? |
No | No aplica |
Los cargos salen de tu saldo de DeepSeek, y la página de precios dice que el saldo otorgado se usa antes del saldo recargado cuando tienes ambos.
Un cálculo rápido para un agente de investigación que ejecuta 200 tareas al día, cada una con una búsqueda y tres fetch:
- 200 búsquedas x $0.00075 = $0.15
- 600 fetch x $0.00075 = $0.45
- Total: $0.60 al día, unos $18 al mes, antes de los tokens del modelo
Como count no cambia el precio, pide hasta 50 resultados en una sola llamada en lugar de paginar. Por el lado del modelo, deepseek-flash cuesta $0.15 por millón de tokens de entrada (fallo de caché, fuera de horas punta) y $0.60 por millón de salida, el doble en horas punta; consulta precios de DeepSeek V4.1 Flash.
Límites de velocidad de la API de Search de DeepSeek
Algunos artículos de terceros citan un límite de 5 QPS. La guía propia de DeepSeek da cifras diferentes, y esas son con las que hay que planificar:
- Search: 100 consultas por segundo
- Fetch: 25 consultas por segundo, más un límite por dominio cuyo valor no se publica
Los límites son por cuenta, se aplican a todas tus claves de API y son independientes de la concurrencia del modelo. Search y Fetch se miden de forma independiente, así que una ráfaga de fetch no consume tu presupuesto de búsqueda. Superarlos devuelve HTTP 429.
Vigila el límite de Fetch por dominio: un agente que obtiene 20 páginas de un mismo sitio de documentación puede alcanzarlo muy por debajo de 25 QPS. Espacia los fetch del mismo dominio y reintenta los 429 con retroceso exponencial.
Endpoints y tu primera llamada a la API de Search de DeepSeek
Ambos endpoints son POST, usan un token bearer y aceptan JSON:
- Search:
https://api.deepseek.com/v1/tools/search - Fetch:
https://api.deepseek.com/v1/tools/fetch
Campos de la solicitud de Search
| Campo | Tipo | Obligatorio | Predeterminado | Notas |
|---|---|---|---|---|
query |
cadena | Sí | ninguno | 1 a 128 caracteres, se permiten operadores |
count |
entero | No | 10 | 1 a 50 |
ori_question |
cadena | No | ninguno | La pregunta original del usuario, 1 a 128 caracteres |
localization |
cadena | No | "" |
Una dirección IP para localizar los resultados |
need_content |
booleano | No | false | Cuando es false, content permanece vacío |
Una solicitud de Search, tomada de la documentación:
curl https://api.deepseek.com/v1/tools/search \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "DeepSeek V4 release", "count": 5, "need_content": true}'
Cada elemento del array results incluye title, url, snippet, summary, content, site_name, site_icon, date (UTC RFC 3339 o null), rerank_score y authority. Filtra por dos de ellos antes de hacer fetch:
rerank_scoreva de 0 a 3. DeepSeek considera 1.5 o más como alta calidad.authorityva de 0 a 4, con -1 para desconocido. 3 o más significa una fuente altamente autorizada.
Una solicitud de fetch toma un campo, url (HTTP o HTTPS, hasta 8,192 caracteres, sin nombre de usuario ni contraseña incrustados):
curl https://api.deepseek.com/v1/tools/fetch \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/article"}'
Devuelve title (que puede estar vacío) y content en Markdown.
Errores que verás
| Código | Significado | ¿Reintentar? |
|---|---|---|
| 400 | Encabezado, cuerpo o valor de campo incorrectos | Corrige la solicitud primero |
| 401 | Clave ausente o no válida | No |
| 402 | Saldo insuficiente | Recarga y luego reintenta |
| 403 | Fetch bloqueado por la política de seguridad | No |
| 404 | Fetch no pudo obtener contenido utilizable | No |
| 408 / 429 / 5xx | Tiempo de espera agotado, límite de velocidad, error del servidor | Sí, después de esperar |
El cuerpo del error sigue el formato de OpenAI: message, type, param (siempre null) y code.
Usar Search desde Claude Code o Codex frente a llamarlo directamente
La ventana gratuita solo se aplica cuando una herramienta de programación hace la llamada por ti, así que la configuración decide la factura.
Claude Code. Apunta Claude Code al endpoint compatible con Anthropic de DeepSeek y la API de DeepSeek ejecuta la herramienta Web Search del lado del servidor. Las variables principales de la página de DeepSeek:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]
Copia el bloque completo, que establece algunas variables de modelo más, desde la página de DeepSeek.
Codex. La búsqueda web integrada de Codex solo funciona con deepseek-v4-pro, según la página de integración de Codex de DeepSeek. El script de configuración desactiva la búsqueda web por defecto, así que establece estas dos líneas en ~/.codex/config.toml y reinicia:
model = "deepseek-v4-pro"
web_search = "live"
La contrapartida: deepseek-v4-pro cuesta más por token que deepseek-flash.
Llamadas directas. Llama a los endpoints tú mismo cuando estés creando tu propio agente o quieras count, need_content y los operadores bajo tu control. Pagas desde la primera llamada exitosa. Si solo quieres un agente que busque cosas mientras programa, usa Claude Code o Codex durante la ventana.
Deja que tu agente de programación pruebe la API de Search de DeepSeek con Apidog CLI
Antes de integrar Search y Fetch en un producto, comprueba que la autenticación, la forma de la respuesta y los errores se comportan como se documenta. Tu agente de programación puede crear y ejecutar esas comprobaciones con Apidog CLI, para que las pruebas vivan en un proyecto que tu equipo vuelve a ejecutar en CI.
Configúralo una vez:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
Luego dale a Claude Code, Codex o el agente que uses un prompt:
In Apidog project <projectId>, add the DeepSeek endpoints POST /v1/tools/search
and POST /v1/tools/fetch with base URL https://api.deepseek.com and bearer auth
from the DEEPSEEK_API_KEY variable. Create test cases that assert: search returns
200 with a results array whose rerank_score values are between 0 and 3; fetch on
https://example.com returns 200 with non-empty content; a bad key returns 401.
Run them against the deepseek environment and summarize any failures.
El agente lee el esquema de cada payload, valida su JSON y luego escribe y ejecuta las pruebas:
apidog environment create deepseek --project <projectId> --base-url https://api.deepseek.com
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file search-endpoint.json
apidog endpoint create --project <projectId> --file search-endpoint.json
apidog cli-schema get test-case-create
apidog test-case create --project <projectId> --file search-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json
Cada ejecución completa hace dos llamadas facturables después de la ventana (una de Search y una de Fetch), así que cuesta $0.0015. La comprobación del 401 no cuesta nada porque las solicitudes fallidas no se facturan. La misma línea apidog run ... -r junit se puede insertar en un pipeline, como se muestra en ejecutar Apidog CLI en CI/CD. Si Claude Code es tu agente, Apidog CLI en Claude Code explica cómo instalar la skill.
El plan Free de Apidog cubre hasta 4 usuarios, así que un equipo pequeño puede compartir el proyecto y su historial de pruebas.
Preguntas frecuentes
¿La API de Search de DeepSeek es gratis después del 31 de octubre? No. A partir de las 16:00 UTC del 31 de octubre de 2026, las llamadas de Search y Fetch a través de Claude Code, Codex y DeepSeek Harness cuestan $0.75 por cada 1,000 solicitudes exitosas, igual que las llamadas directas.
¿La API de Fetch de DeepSeek es gratis? Solo bajo los mismos términos que Search: gratis cuando Claude Code, Codex o DeepSeek Harness la llaman del lado del servidor antes de la fecha límite, y después $0.75 por cada 1,000 solicitudes exitosas.
¿Necesito una clave de API de DeepSeek para usar la búsqueda gratuita en Claude Code? Sí. Claude Code tiene que ejecutarse con una clave de API de DeepSeek a través de https://api.deepseek.com/anthropic, y los tokens del modelo que gasta al resumir resultados se facturan con normalidad.
¿Cuál es el límite de velocidad de la API de Search de DeepSeek? La guía de DeepSeek indica 100 QPS para Search y 25 QPS para Fetch por cuenta, más un límite por dominio no publicado en Fetch. Superarlos devuelve HTTP 429.
¿Se me cobra cuando una búsqueda no devuelve nada? No. Los resultados vacíos, las solicitudes fallidas y los tiempos de espera agotados no se facturan. Search solo factura con HTTP 200 y un array results no vacío.
¿Pedir más resultados cuesta más? No. El campo count (1 a 50) no cambia el precio, así que una búsqueda de 50 resultados cuesta lo mismo que una de 5 resultados.