Nota do autor: A DeepSeek liberou a Search & Fetch API, e a APIYI já disponibilizou simultaneamente os modelos deepseek-search e deepseek-fetch. Neste artigo, reunimos as principais informações do guia oficial, analisamos o impacto para desenvolvedores de RAG, Agents e sistemas de perguntas e respostas conectados à web, além de apresentar os preços e como integrar pela APIYI.
A documentação oficial da DeepSeek adicionou recentemente um guia de Search e publicou um anúncio em sua seção de notícias: a Search & Fetch API foi liberada oficialmente para desenvolvedores. Isso significa que, ao realizar a invocação do modelo DeepSeek, agora é possível contar com recursos nativos para “pesquisar na web + extrair conteúdo de páginas”, sem precisar recorrer a serviços de busca de terceiros por conta própria.
E isso não é boato. A página do guia de Search na documentação oficial e os comunicados já estão no ar, e já rolam discussões dedicadas no Hacker News, mostrando que a comunidade global de desenvolvedores está de olho. A análise dos recursos oficiais aqui se baseia estritamente em informações públicas (os parâmetros exatos de requisição devem ser consultados na documentação oficial); os detalhes de disponibilidade e preços na plataforma APIYI estão explicados em uma seção dedicada mais adiante.
Destaques: entenda em 3 minutos os pontos essenciais da Search & Fetch API da DeepSeek, a divisão de tarefas de cada recurso e o impacto real para aplicações de RAG, Agents e respostas conectadas à internet.
Já disponível na APIYI: a APIYI adicionou o deepseek-search e o deepseek-fetch, com cobrança por requisições bem-sucedidas, sem consumir tokens; o valor padrão na plataforma é de $0,0009 por chamada e, com o bônus de 20% para recargas corporativas, sai por $0,75 a cada 1.000 chamadas, equiparando-se ao preço oficial.

Visão geral da Search & Fetch API da DeepSeek
Vamos começar com uma tabela direta ao ponto com tudo o que já está confirmado. Listamos apenas o que pode ser verificado nos canais oficiais, sem especulações sobre preços não divulgados ou benchmarks preliminares.
| Item | Detalhes |
|---|---|
| Lançamento | Oficial da DeepSeek |
| Fontes | Guia de Search na documentação oficial da API e comunicados oficiais |
| Conteúdo principal | Disponibilização de dois recursos: Search (busca na web) e Fetch (extração de conteúdo de páginas) |
| Público-alvo | Desenvolvedores que usam a API da DeepSeek para criar sistemas de Q&A web, RAG e Agents |
| Repercussão | Tópicos dedicados no Hacker News com grande engajamento |
| Preços e cotas | Os preços e limites oficiais devem ser consultados na documentação e no painel oficial; os detalhes de tarifação na APIYI estão na seção abaixo |
A divisão de tarefas entre o Search e o Fetch da DeepSeek
Pelos próprios nomes, dá para notar que se trata de uma dupla dinâmica. O Search resolve o “onde procurar”: o modelo gera consultas de busca com base na pergunta do usuário e obtém uma lista de resultados candidatos. Já o Fetch resolve o “o que ler”: ele acessa uma URL específica e extrai o corpo do texto da página para que o modelo possa ler e citar como fonte.
A grande vantagem de separar essas duas etapas é o controle. Em muitos cenários, o resumo dos resultados da busca já é suficiente para responder à dúvida, sem a necessidade de raspar cada página individualmente. Em outros casos, o usuário envia diretamente um link específico — aí você só precisa do Fetch, dispensando o Search. Ao desacoplar essas ferramentas, você pode combiná-las como preferir e encontrar o equilíbrio perfeito entre qualidade e custo.
| Recurso | Problema que resolve | Entrada típica | Saída típica | Cenários ideais |
|---|---|---|---|---|
| Search | Onde encontrar informações | Pergunta em linguagem natural ou palavras-chave | Lista de páginas web candidatas | Q&A de notícias, checagem de fatos, pesquisas de mercado |
| Fetch | O que ler detalhadamente | URL específica de uma página | Conteúdo textual da página | Resumo de links, leitura de documentação, análise concorrencial |
| Search + Fetch | Buscar primeiro e aprofundar depois | Questões complexas de pesquisa | Conclusões consolidadas de múltiplas fontes | Deep Research, pesquisa autônoma com Agents |

Por que a API DeepSeek Search & Fetch merece a sua atenção
A solução oficial para o limite de conhecimento dos modelos
Todo Modelo de Linguagem Grande possui uma data de corte nos seus dados de treinamento; o modelo em si não faz ideia do “que aconteceu hoje”. No passado, se você quisesse que o DeepSeek respondesse a perguntas em tempo real, geralmente precisava integrar uma API de mecanismo de busca por conta própria, criar um web scraper para extrair o conteúdo das páginas e injetar tudo na janela de contexto. Era um fluxo longo e com alto custo de manutenção.
Com o lançamento oficial do Search & Fetch, esse fluxo tem tudo para ser encurtado drasticamente. Os próprios desenvolvedores do modelo entendem melhor do que ninguém como ele lida com chamadas de ferramentas (tool calling). Por isso, as capacidades de busca integradas de fábrica costumam ser bem mais afinadas no formato da requisição e na organização dos dados, o que ajuda muito a evitar aquele clássico problema de “o modelo encontrou a informação, mas não soube usá-la”.
De um simples “modelo de perguntas e respostas” a uma “infraestrutura para Agents”
Outro sinal importante aqui é a mudança de posicionamento. A busca na web e a leitura de páginas são as duas ferramentas mais básicas para qualquer Agent; praticamente todas as soluções de pesquisa automatizada, browser agents e produtos estilo Deep Research dependem delas. O fato de o DeepSeek disponibilizar essas duas capacidades como APIs oficiais mostra que ele está deixando de ser apenas uma interface de chat para se tornar uma infraestrutura capaz de sustentar fluxos de trabalho completos de Agents.
Para desenvolvedores que já usam o DeepSeek como modelo principal, essa novidade é extremamente prática. Conseguir resolver o acesso à internet dentro do mesmo ecossistema deixa a stack técnica muito mais enxuta, além de eliminar uma camada inteira de dependências de terceiros na hora de debugar problemas.
Como integrar a API DeepSeek Search & Fetch
Exemplo básico: testando a invocação inicial do DeepSeek
Antes de plugar os recursos de navegação web, vale a pena garantir que a chamada básica ao modelo esteja funcionando redonda. O código abaixo utiliza a interface compatível com OpenAI para fazer a invocação do modelo DeepSeek; você consegue rodar com cerca de 10 linhas:
import openai
client = openai.OpenAI(
api_key="SUA_CHAVE_API",
base_url="https://api.apiyi.com/v1" # Usando a interface unificada da APIYI
)
response = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "Explique em três frases a importância da busca na web para um Modelo de Linguagem Grande"}]
)
print(response.choices[0].message.content)
Vale ressaltar que os campos específicos de requisição, parâmetros de ativação e a estrutura de retorno do Search & Fetch oficial devem seguir o guia oficial do DeepSeek Search. O exemplo completo a seguir adota o padrão genérico de Function Calling para demonstrar o fluxo de “o modelo decide quando pesquisar e quando extrair a página”. Isso ajuda a entender a lógica por trás e facilita a migração para a chamada nativa assim que os parâmetros oficiais estiverem definidos no seu projeto.
Ver código completo da implementação: Simulando o fluxo de Search + Fetch via Function Calling
import json
import openai
import requests
client = openai.OpenAI(
api_key="SUA_CHAVE_API",
base_url="https://api.apiyi.com/v1" # Interface compatível com OpenAI da APIYI
)
# Definindo duas ferramentas: busca e extração (para demonstração, substituível pelas capacidades nativas oficiais)
tools = [
{
"type": "function",
"function": {
"name": "web_search",
"description": "Pesquisa na web com base em palavras-chave e retorna uma lista de páginas candidatas",
"parameters": {
"type": "object",
"properties": {"query": {"type": "string"}},
"required": ["query"]
}
}
},
{
"type": "function",
"function": {
"name": "fetch_page",
"description": "Extrai o conteúdo textual de uma URL específica",
"parameters": {
"type": "object",
"properties": {"url": {"type": "string"}},
"required": ["url"]
}
}
}
]
def web_search(query: str) -> str:
# Conecte aqui sua implementação de busca ou substitua pela capacidade oficial de Search
return json.dumps([{"title": "Resultado de Exemplo", "url": "https://example.com"}])
def fetch_page(url: str) -> str:
# Implementação simplificada de extração; em produção, trate encoding, extração de texto limpo e timeouts
try:
resp = requests.get(url, timeout=10)
return resp.text[:4000]
except Exception as e:
return f"Falha na extração: {e}"
TOOL_MAP = {"web_search": web_search, "fetch_page": fetch_page}
def ask(question: str, max_rounds: int = 4) -> str:
messages = [
{"role": "system", "content": "Quando precisar de informações atualizadas, pesquise primeiro, depois extraia as páginas essenciais e cite as fontes ao responder."},
{"role": "user", "content": question}
]
for _ in range(max_rounds):
resp = client.chat.completions.create(
model="deepseek-chat",
messages=messages,
tools=tools
)
msg = resp.choices[0].message
if not msg.tool_calls:
return msg.content
messages.append(msg)
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
result = TOOL_MAP[call.function.name](**args)
messages.append({
"role": "tool",
"tool_call_id": call.id,
"content": result
})
return "Número máximo de iterações atingido sem concluir a resposta"
print(ask("Resuma os principais pontos das discussões recentes sobre a DeepSeek Search API"))
🚀 Início Rápido: A recomendação é pegar alguns créditos de teste na APIYI (apiyi.com) e validar primeiro a invocação básica e o fluxo de Function Calling do DeepSeek. A APIYI já disponibiliza o
deepseek-searche odeepseek-fetch; depois de validar a lógica, basta trocar as ferramentas simuladas do exemplo por essas duas interfaces nativas, como veremos na próxima seção.
APIYI Já Disponibilizou o DeepSeek Search e Fetch: Cobrança e Integração
A APIYI (apiyi.com) já disponibilizou essas duas capacidades, correspondendo a dois novos nomes de modelo: deepseek-search e deepseek-fetch. Eles não são modelos de conversa, mas sim interfaces de ferramentas voltadas especificamente para agents e RAG realizarem buscas na web e extração de dados. As requisições não consomem tokens, sendo tarifadas apenas pelo número de chamadas bem-sucedidas.
| Item | deepseek-search | deepseek-fetch |
|---|---|---|
| Rota do endpoint | /v1/tools/search |
/v1/tools/fetch |
| Função | Busca na web, retornando páginas candidatas | Extração do conteúdo de uma página a partir de uma URL |
| Modelo de cobrança | Cobrado por chamada bem-sucedida, sem consumo de tokens | Cobrado por chamada bem-sucedida, sem consumo de tokens |
| Preço na plataforma | US$ 0,0009 / chamada | US$ 0,0009 / chamada |
| Chamadas com falha | Sem cobrança | Sem cobrança |
| Grupos disponíveis | default, svip | default, svip |
Em relação ao preço, vale a pena colocar os números na ponta do lápis. O valor de tabela na plataforma é de US$ 0,0009 por chamada. Para clientes com recargas maiores, somando o bônus de 20%, o custo efetivo fica em US$ 0,75 por 1.000 chamadas, equiparando-se ao valor oficial do DeepSeek e com a vantagem de já incluir tributos. Ou seja: usar a APIYI não adiciona nenhum custo extra de ágio e ainda permite gerenciar busca, extração e modelos de conversa em uma única conta e com uma fatura unificada.
A integração segue exatamente o padrão oficial: basta trocar o domínio raiz da requisição pelo endereço da APIYI, mantendo os parâmetros e a estrutura de resposta documentados originalmente. O guia completo pode ser consultado na documentação da APIYI: docs.apiyi.com/api-capabilities/deepseek-search-fetch/overview.
Vale ressaltar dois pontos importantes ao integrar. Primeiro: os endpoints de busca e extração não consomem tokens em si, mas, ao repassar o texto extraído para o modelo de conversa, ele ocupará a janela de contexto e gerará cobrança de tokens na invocação do modelo. Por isso, a recomendação de limitar rodadas e truncar textos longos continua indispensável. Segundo: a isenção de cobrança em caso de falha protege contra gastos desnecessários com páginas fora do ar ou timeouts de rede, mas sua aplicação ainda deve conter limites de repetição (retries) e planos de contingência (fallback).
🔗 Como começar: confirme se o grupo da sua conta no painel da APIYI está como default ou svip para começar a usar o deepseek-search e o deepseek-fetch. Os informativos de novidades e a central de documentação mantêm as instruções sempre atualizadas.
Comparativo: DeepSeek Search & Fetch API vs. Outras Soluções de Acesso à Web

Antes do surgimento das ferramentas oficiais, os desenvolvedores contavam com dois caminhos principais: montar pipelines próprios de busca e raspagem ou recorrer a APIs de busca de terceiros. A tabela abaixo apresenta uma análise comparativa qualitativa do ponto de vista de engenharia (para valores exatos, consulte os canais oficiais de cada serviço).
| Solução | Dificuldade de Integração | Custo de Manutenção | Compatibilidade com o Modelo | Nível de Controle | Onde Usar |
|---|---|---|---|---|---|
| Crawler próprio + Busca | Alta | Alto | Exige ajustes manuais contínuos | Máximo | Servidores próprios |
| API de busca de terceiros | Média | Médio | Formato genérico, requer adaptação | Médio | Provedores de busca em geral |
| Search & Fetch nativos do DeepSeek | Baixa | Baixo | Integração oficial, alta compatibilidade | Depende dos parâmetros da API | API oficial da DeepSeek; disponível na APIYI apiyi.com (deepseek-search / deepseek-fetch) |
Análise Comparativa Detalhada
Desenvolvimento próprio: montar um crawler e uma infraestrutura própria de busca garante o maior nível de controle sobre quais sites varrer, como tratar o conteúdo e qual lógica de ranqueamento aplicar. Contudo, traz também o custo mais elevado: lidar com sistemas antibot, decodificação de páginas e parsing de texto exige manutenção constante. Já a abordagem nativa do DeepSeek atende perfeitamente quem precisa de agilidade e prefere não se preocupar com a manutenção de crawlers.
APIs de busca de terceiros: serviços consolidados de busca oferecem boa cobertura de fontes e ecossistemas maduros. O contraponto é que o retorno costuma vir em formatos genéricos, exigindo etapas intermediárias de tratamento antes de enviar os dados ao modelo. Além disso, adicionar outro provedor significa lidar com mais uma fatura e outro ponto único de falha. Para projetos cujo modelo central já é o DeepSeek, as ferramentas nativas tornam a arquitetura muito mais enxuta.
💡 Qual escolher? Não existe uma escolha universal. Cenários de alta conformidade ou que exigem fontes restritas continuam pedindo soluções próprias; já iniciativas com foco em tempo de lançamento se beneficiam muito mais das ferramentas nativas. Uma boa prática é testar ambos os modelos e abordagens por meio de uma interface integrada na APIYI (apiyi.com) antes de bater o martelo.
Análise de impacto da API DeepSeek Search & Fetch para desenvolvedores
Impacto direto em 4 perfis de desenvolvedores
O impacto dessa liberação varia bastante conforme o tipo de projeto. Abaixo, resumimos o que muda na prática para quatro perfis comuns de desenvolvedores:
| Tipo de Desenvolvedor | Principal Impacto | Ação Recomendada |
|---|---|---|
| Produtos de busca e perguntas/respostas com acesso à web | Pode substituir pipelines de busca próprios, simplificando a arquitetura | Fazer testes canary com baixo tráfego para comparar qualidade e latência das respostas |
| Aplicações RAG (bases de conhecimento) | Permite complementar o conhecimento privado com dados públicos em tempo real | Separar claramente a base interna das fontes públicas para evitar confusões |
| Desenvolvedores de Agentes de IA | Ganham ferramentas básicas nativas, reduzindo o custo de desenvolvimento de tools | Definir um limite bem ajustado para as rodadas de busca e raspagem (fetch) |
| Ferramentas de pesquisa e conteúdo | O fluxo de resumo de links e análise de mercado fica muito mais fluido | Prestar atenção à atribuição de fontes e conformidade com direitos autorais |
Impacto no ecossistema da indústria
- Acesso à web se torna recurso padrão nas APIs: Os principais provedores de modelos estão integrando busca e leitura de páginas como capacidades nativas. O pacote “modelo + ferramentas” está virando tendência, o que reduz bastante a competitividade de interfaces que oferecem apenas chat puro.
- Diferenciação nos serviços de busca de terceiros: APIs de busca genéricas continuam tendo mercado, mas devem migrar cada vez mais para fontes especializadas, nichos verticais e recuperação corporativa altamente controlável, atuando de forma complementar às funções nativas dos modelos.
- Barreira de entrada para produtos de agentes ainda menor: Com as ferramentas básicas sendo fornecidas diretamente pelos provedores, as equipes e startups podem concentrar esforços no design dos fluxos de trabalho e no refinamento das regras de negócio, sem precisar reinventar a roda.
Cuidados essenciais ao integrar a DeepSeek Search & Fetch
Ter acesso à internet é uma mão na roda, mas traz novos desafios de engenharia. O primeiro deles é o controle de custos: operações de busca e extração costumam inflar bastante o tamanho da janela de contexto, elevando o consumo de tokens no modelo de chat (vale destacar que as chamadas diretas de busca e extração cobram por requisição e não consomem tokens). Por isso, vale a pena configurar um teto para as rodadas de invocação do modelo e para o tamanho do conteúdo capturado. O segundo ponto é a confiabilidade dos resultados: como a qualidade do conteúdo na web aberta oscila bastante, preserve as fontes nas respostas para que o usuário final consiga checar as informações por conta própria.
O terceiro cuidado envolve a conformidade jurídica. Ao extrair páginas da web, observe sempre os termos de uso e as exigências de direitos autorais dos sites de destino — algo ainda mais crítico se você desenvolve produtos voltados ao consumidor final. Por fim, atente-se à estabilidade: qualquer recurso recém-lançado passa por períodos de ajustes finos. O ideal em ambientes de produção é manter uma estratégia de fallback, como regredir graciosamente para a resposta pura do modelo caso a conexão com a web falhe.

Perguntas Frequentes (FAQ)
Q1: O que é a API DeepSeek Search & Fetch?
É uma combinação oficial de recursos de acesso à internet disponibilizada pela DeepSeek. O Search é responsável por pesquisar resultados relevantes na web com base na pergunta, enquanto o Fetch extrai o conteúdo do corpo de páginas específicas. Juntos, eles permitem que o modelo DeepSeek responda a perguntas em tempo real e forneça conclusões embasadas em fontes reais.
Q2: Qual é a diferença entre usar o DeepSeek Search & Fetch e integrar uma API de busca própria?
Integrar uma API de busca própria dá mais controle, mas você precisa lidar por conta própria com a formatação dos resultados, extração de texto e suporte a múltiplos fornecedores. O recurso nativo da DeepSeek já vem integrado de fábrica, tem uma sintonia muito mais fina com o modelo e um fluxo de processamento mais direto; o contraponto é que o nível de customização fica restrito aos parâmetros liberados oficialmente.
Q3: Quando a API DeepSeek Search & Fetch estará disponível para uso?
O guia de busca na documentação oficial e os comunicados já estão no ar, o que significa que o recurso já foi liberado. A APIYI também já disponibilizou o deepseek-search e o deepseek-fetch nos grupos default e svip, custando $0,0009 por chamada na plataforma, e sem cobrança em caso de falha. Para preços e cotas nos canais oficiais, consulte a documentação e o painel de controle da própria DeepSeek.
Q4: Como testar rapidamente os recursos de web da DeepSeek via API?
Recomendamos seguir este passo a passo:
1. Acesse a APIYI em apiyi.com, crie sua conta e gere sua chave API
2. Use o exemplo minimalista deste artigo (configurando a base_url para `https://api.apiyi.com/v1`) para testar uma invocação do modelo DeepSeek básica
3. Consulte a documentação da APIYI e chame os endpoints `/v1/tools/search` e `/v1/tools/fetch` (nomes de modelo: deepseek-search e deepseek-fetch)
4. Utilize o fluxo completo de Function Calling do exemplo, substituindo as ferramentas simuladas por essas duas interfaces nativas
Q5: Quais são as limitações conhecidas do DeepSeek Search & Fetch?
Como as informações públicas ainda são limitadas, vale ter em mente alguns pontos: o custo das chamadas aumenta conforme o volume de buscas e extrações; a qualidade dos resultados na web varia bastante, sendo essencial manter as fontes para verificação; a extração de páginas envolve termos de serviço e conformidade de direitos autorais; e, como o recurso acabou de ser lançado, os parâmetros podem mudar, então é bom manter uma estratégia de contingência (fallback) em produção.
Principais Destaques da API DeepSeek Search & Fetch (Key Takeaways)
- Informação principal: A DeepSeek liberou oficialmente os recursos de Search e Fetch para acesso à web, com documentação e anúncios já disponíveis.
- Divisão de funções: O Search encontra as informações e o Fetch lê o conteúdo das páginas. Eles podem ser usados de forma independente ou combinados conforme a necessidade.
- Maior benefício: Reduz o caminho da busca na web, eliminando o trabalho de criar raspadores (crawlers) próprios ou adaptar ferramentas de terceiros.
- Principais beneficiados: Desenvolvedores de ferramentas de perguntas e respostas com busca web, RAG, agentes de IA e produtos focados em pesquisa de conteúdo.
- Já disponível na APIYI: Os modelos deepseek-search e deepseek-fetch são cobrados por chamada bem-sucedida (não consomem tokens), a $0,0009 por requisição na plataforma, sem cobrança se falhar.
- Comparativo de preço: Com o bônus de 20% para recargas de grandes volumes, o valor fica em $0,75 por 1.000 chamadas — mesmo preço do site oficial e já com impostos inclusos.
- Dica de integração: Sempre confirme os parâmetros de requisição na documentação oficial e fique atento aos custos, conformidade legal e planos de contingência (fallback).
- Como começar: Já liberado nos grupos default e svip; basta trocar o domínio base dos exemplos oficiais pelo domínio da APIYI.
Resumo
Os pontos principais da DeepSeek Search & Fetch API:
- Acesso à web resolvido oficialmente: Com os recursos de Search e Fetch, os modelos DeepSeek agora conseguem obter informações de páginas web em tempo real diretamente.
- Infraestrutura para Agentes: A busca e a leitura de páginas web são ferramentas essenciais para agentes autônomos; a disponibilização nativa reduz ainda mais a barreira técnica para os desenvolvedores.
- Avalie com calma antes de ir para produção: Prepare planos de contingência considerando quatro pilares — custo, confiabilidade, conformidade e estabilidade — antes de substituir gradualmente o seu fluxo atual.
A APIYI já disponibilizou o deepseek-search e o deepseek-fetch, cobrando apenas por requisições bem-sucedidas — se falhar, não desconta nada. Para os times que já utilizam o DeepSeek, este é o momento ideal para testar esse recurso: comece rodando um volume pequeno de tráfego para comparar a qualidade das respostas e os custos antes de migrar tudo de vez. Vale a pena validar os resultados pela APIYI em apiyi.com, que oferece uma interface padronizada compatível com a OpenAI, facilitando bastante a comparação e a alternância entre o DeepSeek e outros modelos de ponta.
📚 Referências
- Documentação Oficial da DeepSeek – Guia de Busca: Visão geral oficial dos recursos Search & Fetch
- Link:
api-docs.deepseek.com/guides/search/ -
Descrição: Consulte aqui os métodos de requisição, parâmetros e estruturas de retorno oficiais
-
Comunicado Oficial da DeepSeek: Página de lançamento oficial disponibilizando essas capacidades
- Link:
api-docs.deepseek.com/news/news261017/ -
Descrição: Entenda o contexto de lançamento e o posicionamento oficial
-
Discussão na Comunidade Hacker News: Thread de discussão entre desenvolvedores globais sobre este lançamento
- Link:
news.ycombinator.com/item?id=50138531 - Descrição: Excelente para acompanhar os feedbacks práticos e pontos de atenção levantados pela comunidade
Autor: Equipe Técnica da APIYI
Troca técnica: Sinta-se à vontade para compartilhar nos comentários a sua experiência de integração com os recursos de busca na web do DeepSeek. Para mais tutoriais e guias de integração, acesse a central de documentação da APIYI em docs.apiyi.com.
