Web search
openrouter:web_search
Permite que qualquer modelo pesquise na web durante uma solicitação. O modelo decide quando pesquisar e o que consultar, o OpenRouter executa a pesquisa no mecanismo configurado e retorna títulos, URLs e trechos, e o modelo os sintetiza em sua resposta com citações.
Como funciona
Para perguntas que precisam de informações atuais, como as notícias desta semana ou os preços de hoje.
- 1
Seu modelo decide que uma pesquisa seria útil e escreve a consulta.
- 2
OpenRouter executa a pesquisa no mecanismo configurado e retorna títulos, URLs e trechos.
- 3
Seu modelo responde com citações e pode pesquisar novamente na mesma requisição.
Provedores e preços
O mecanismo padrão, auto, usa a pesquisa nativa do provedor do modelo nos endpoints que a disponibilizam e recorre ao Exa nos demais casos. Defina engine explicitamente para fixar um provedor.
Exa
US$ 0,007 / request
instant,fast,auto(padrão) modosPesquisa com trechos relevantes das páginas em destaque.
instant,fast,auto(padrão) modos- US$ 0,007 / request
deep-lite,deepmodos- US$ 0,012 / request
deep-reasoningmodo- US$ 0,015 / request
- Cada result após os primeiros 10 (até 15 adicionais)
- US$ 0,001 / result
Parallel
US$ 0,005 / request
basic(padrão),advancedmodosPesquisa na web com modos rápido e avançado.
turbo,fastmodos- US$ 0,001 / request
basic(padrão),advancedmodos- US$ 0,005 / request
- Cada result após os primeiros 10 (até 15 adicionais)
- US$ 0,001 / result
Perplexity Search
US$ 0,005 / request
Resultados da web classificados com filtragem por domínio.
Firecrawl
US$ 0,005 / request
Pesquise usando o Firecrawl.
- Cada result após os primeiros 0 (até 25 adicionais)
- US$ 0,0125 / result
OpenAI
NativoPesquisa na web integrada ao GPT-4.1, GPT-5 e posteriores, o3 e o4-mini.
Via OpenAI, Azure
Anthropic
NativoPesquisa na web integrada no Claude 3.5 Haiku, Claude 3.7 Sonnet e Claude 4 e posteriores.
Via Anthropic, Claude Platform on AWS, Amazon Bedrock, Google Vertex
Google
NativoFundamentação com pesquisa no Gemini 3 e versões posteriores.
Via Google AI Studio, Google Vertex
xAI
NativoPesquisa na web e pesquisa no X integradas no Grok 4 e versões posteriores.
Via xAI
Os custos padrão de tokens do modelo se aplicam a todas as solicitações.
Como usar esta ferramenta
O OpenRouter executa a ferramenta durante a solicitação e retorna o resultado ao modelo, portanto não é necessário um ciclo de ferramentas no lado do cliente.
APIs compatíveis: Chat Completions, Responses, and Anthropic Messages.
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5.2",
"tools": [
{
"type": "openrouter:web_search"
}
],
"messages": [
{
"role": "user",
"content": "What were the major AI announcements this week?"
}
]
}'Configuração, parâmetros e exemplos na documentação.
Ler o guia de integraçãoAvaliações de desempenho
- BrowseComp
Fatos difíceis de localizar na web atual, com pontuação baseada em pesquisa persistente de várias etapas.
- DeepSearchQA
Perguntas cujas respostas são listas, avaliadas pela recuperação exaustiva sem conteúdo de preenchimento.
- HLE
Humanity's Last Exam como teste de desempenho de pesquisa: perguntas de especialistas respondidas com pesquisa em tempo real.
- WideSearch
Preencha uma tabela inteira; a precisão por item de resposta pontua correspondências parciais.
Perguntas frequentes
Ferramentas relacionadas
Pesquisa e web