Janela Gratuita da API de Pesquisa DeepSeek: Preços, Fetch API e o Corte de 31 de Outubro

Resposta rápida: A API DeepSeek Search é gratuita apenas dentro de três ferramentas de codificação, e somente até 31 de outubro de 2026 às 16:00 UTC. Chamadas de Search e Fetch que o Claude Code, o Codex ou o DeepSeek Harness fazem no lado do servidor não custam nada até lá. Depois disso, e para toda chamada direta aos endpoints, você paga US$ 0,75 por 1.000 requisições bem-sucedidas por endpoint. Chamadas com falha, resultados vazios e timeouts nunca são cobrados.

A DeepSeek abriu suas APIs Search e Fetch para todos em 17 de outubro de 2026, junto com o lançamento do DeepSeek-V4.1-Flash-1017. Elas fornecem a um agente resultados web atualizados para uma consulta e uma cópia limpa em Markdown de qualquer página. Este guia cobre o que é gratuito, quanto custa depois da janela, limites de taxa, uma primeira requisição e como testar os dois endpoints com o Apidog CLI.

Todos os fatos abaixo vêm do guia de Search & Fetch da DeepSeek e da página de preços, consultados em 28 de outubro de 2026.

A API DeepSeek Search é gratuita?

Sim, com dois limites: de onde você a chama e quando. A documentação da DeepSeek diz que chamadas de Search e Fetch feitas no lado do servidor por meio do DeepSeek Harness, Claude Code ou Codex são “atualmente gratuitas”. A cobrança por requisição dessas chamadas começa às 00:00 de 1º de novembro de 2026 em UTC+8, o que corresponde a 16:00 UTC de 31 de outubro de 2026.

Duas ressalvas impedem que esta seja uma rota realmente de custo zero:

1. Você ainda precisa de uma chave de API DeepSeek com saldo. A janela gratuita cobre as chamadas de Search, não o modelo. A página de integração com o Claude Code da DeepSeek diz que resumir os resultados de busca usa requisições extras ao LLM, e esses tokens são cobrados aos preços normais do modelo.
2. A janela cobre apenas chamadas de ferramentas no lado do servidor. A documentação a restringe a essas três ferramentas. Se o seu próprio código chamar os endpoints, você paga desde a primeira requisição bem-sucedida.

Se o que você quer é um modelo DeepSeek gratuito em vez de busca gratuita, nosso guia sobre se a DeepSeek é gratuita lista todas as rotas, e chave de API DeepSeek gratuita aborda a própria chave.

O que as APIs Search e Fetch da DeepSeek fazem

A API DeepSeek Search recebe uma consulta e retorna resultados web estruturados: título, URL, snippet, um resumo mais longo voltado para modelos, um campo opcional com o conteúdo completo da página, uma pontuação de relevância e uma pontuação de autoridade. A API DeepSeek Fetch recebe uma URL e retorna o título e o conteúdo dessa página em Markdown. Juntas, elas dão a um agente busca e leitura em duas chamadas.

Um agente de pesquisa normalmente faz uma busca e depois o fetch de duas ou três páginas, e cada uma é uma chamada cobrável separada após a janela. A busca aceita operadores: site:, -site:, "phrase", -term, lang:en,ja, after: e before:.

Você pode comparar isso com outras opções em nossa compilação de APIs de busca web gratuitas, a API de busca web do Claude e a API Search da Perplexity.

Preços da API DeepSeek Search após a janela gratuita

Assim que a janela se fecha, os dois endpoints cobram da mesma forma:

As cobranças saem do seu saldo DeepSeek, e a página de preços diz que o saldo concedido é usado antes do saldo recarregado quando você tem os dois.

Um cálculo rápido para um agente de pesquisa que executa 200 tarefas por dia, cada uma com uma busca e três fetches:

• 200 buscas x US$ 0,00075 = US$ 0,15
• 600 fetches x US$ 0,00075 = US$ 0,45
• Total: US$ 0,60 por dia, cerca de US$ 18 por mês, antes dos tokens do modelo

Como o count não altera o preço, peça até 50 resultados em uma única chamada em vez de paginar. Do lado do modelo, o deepseek-flash custa US$ 0,15 por milhão de tokens de entrada (cache miss, fora do horário de pico) e US$ 0,60 por milhão de saída, o dobro em horários de pico; veja preços do DeepSeek V4.1 Flash.

Limites de taxa da API DeepSeek Search

Alguns artigos de terceiros citam um limite de 5 QPS. O guia da própria DeepSeek traz números diferentes, e são esses que você deve usar como base:

• Search: 100 consultas por segundo
• Fetch: 25 consultas por segundo, além de um limite por domínio cujo valor não é publicado

Os limites são por conta, valem para todas as suas chaves de API e são independentes da concorrência do modelo. Search e Fetch são medidos separadamente, então uma rajada de fetches não consome seu orçamento de buscas. Ultrapassá-los retorna HTTP 429.

Fique atento ao limite de Fetch por domínio: um agente que busca 20 páginas de um mesmo site de documentação pode atingi-lo bem abaixo de 25 QPS. Espaçe os fetches do mesmo domínio e repita os 429 com backoff.

Endpoints e sua primeira chamada à API DeepSeek Search

Os dois endpoints usam POST, um bearer token e recebem JSON:

• Search: https://api.deepseek.com/v1/tools/search
• Fetch: https://api.deepseek.com/v1/tools/fetch

Campos da requisição de Search

Uma requisição de Search, extraída da documentação:

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 item do array results traz title, url, snippet, summary, content, site_name, site_icon, date (RFC 3339 em UTC ou null), rerank_score e authority. Filtre por dois deles antes de fazer o fetch:

• O rerank_score vai de 0 a 3. A DeepSeek considera 1,5 ou mais como alta qualidade.
• O authority vai de 0 a 4, com -1 para desconhecido. 3 ou mais significa uma fonte altamente autoritativa.

Uma requisição de fetch recebe um único campo, url (HTTP ou HTTPS, até 8.192 caracteres, sem nome de usuário ou senha embutidos):

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"}'

Ela retorna title (que pode estar vazio) e content em Markdown.

Erros que você vai encontrar

O corpo do erro segue o formato da OpenAI: message, type, param (sempre null) e code.

Usar o Search pelo Claude Code ou Codex versus chamá-lo diretamente

A janela gratuita só se aplica quando uma ferramenta de codificação faz a chamada por você, então a configuração é o que determina a conta.

Claude Code. Aponte o Claude Code para o endpoint compatível com Anthropic da DeepSeek e a API da DeepSeek executa a ferramenta Web Search no lado do servidor. As variáveis principais da página da DeepSeek:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]

Copie o bloco completo, que define mais algumas variáveis de modelo, da página da DeepSeek.

Codex. A busca web integrada do Codex funciona apenas com deepseek-v4-pro, segundo a página de integração com o Codex da DeepSeek. O script de configuração desativa a busca web por padrão, então defina estas duas linhas em ~/.codex/config.toml e reinicie:

model = "deepseek-v4-pro"
web_search = "live"

O trade-off: o deepseek-v4-pro custa mais por token do que o deepseek-flash.

Chamadas diretas. Chame os endpoints você mesmo quando estiver construindo seu próprio agente ou quiser ter count, need_content e os operadores sob seu controle. Você paga desde a primeira chamada bem-sucedida. Se você só quer um agente que pesquise coisas enquanto programa, use o Claude Code ou o Codex durante a janela.

Deixe seu agente de codificação testar a API DeepSeek Search com o Apidog CLI

Antes de integrar Search e Fetch a um produto, comprove que a autenticação, o formato da resposta e os erros se comportam conforme a documentação. Seu agente de codificação pode criar e executar essas verificações com o Apidog CLI, para que os testes fiquem em um projeto que sua equipe reexecute no CI.

Configure uma 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

Depois, dê ao Claude Code, ao Codex ou ao agente que você usar um único 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.

O agente lê o esquema de cada payload, valida o JSON e então escreve e executa os testes:

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 execução completa faz duas chamadas cobráveis após a janela (uma de Search, uma de Fetch), então custa US$ 0,0015. A verificação de 401 não custa nada, porque requisições com falha não são cobradas. A mesma linha apidog run ... -r junit entra em um pipeline, como mostrado em executar o Apidog CLI em CI/CD. Se o Claude Code é o seu agente, Apidog CLI no Claude Code explica a instalação da skill.

O plano gratuito do Apidog cobre até 4 usuários, então uma equipe pequena pode compartilhar o projeto e seu histórico de testes.

Perguntas frequentes

A API DeepSeek Search é gratuita depois de 31 de outubro? Não. A partir das 16:00 UTC de 31 de outubro de 2026, chamadas de Search e Fetch pelo Claude Code, Codex e DeepSeek Harness custam US$ 0,75 por 1.000 requisições bem-sucedidas, o mesmo que chamadas diretas.

A API DeepSeek Fetch é gratuita? Apenas nos mesmos termos do Search: gratuita quando o Claude Code, o Codex ou o DeepSeek Harness a chama no lado do servidor antes do prazo final, e depois US$ 0,75 por 1.000 requisições bem-sucedidas.

Preciso de uma chave de API DeepSeek para usar a busca gratuita no Claude Code? Sim. O Claude Code precisa rodar com uma chave de API DeepSeek por meio de https://api.deepseek.com/anthropic, e os tokens de modelo gastos para resumir resultados são cobrados normalmente.

Qual é o limite de taxa da API DeepSeek Search? O guia da DeepSeek lista 100 QPS para Search e 25 QPS para Fetch por conta, além de um limite por domínio não publicado no Fetch. Ultrapassá-los retorna HTTP 429.

Sou cobrado quando uma busca não retorna nada? Não. Resultados vazios, requisições com falha e timeouts não são cobrados. O Search só cobra em HTTP 200 com um array results não vazio.

Pedir mais resultados custa mais? Não. O campo count (de 1 a 50) não altera o preço, então uma busca com 50 resultados custa o mesmo que uma com 5.