Pular para o conteúdo
NovidadesNovo

Conheça o Search

Search
Uma busca sobre como as bombas de calor funcionam em climas frios em POST /v1/search: três páginas com o logotipo do site e a pontuação, o trecho da primeira com a parte que responde destacada e a precisão no FRAMES: 68,5% com Pro Search e 66,5% com Search

Dê busca na web ao seu agente em uma só chamada: cada resultado chega com os trechos da página que respondem à busca, por 0,5 crédito a busca.

O que você recebe

  • results: até 10 páginas para a busca em ordem de pontuação, cada uma com url, title, snippet e uma relevância score de 0 a 1.
  • text: os trechos de cada página que respondem à busca, até 10.000 caracteres por resultado, prontos para passar ao seu modelo.
  • publishedDate e siteName quando a página os declara.
  • A ferramenta web_search do servidor MCP do querying.ai, pelo mesmo preço, para Claude Code, Codex, Cursor e outros clientes MCP.

Como funciona

Envie uma busca para POST /v1/search e a requisição fica aberta até os resultados chegarem na mesma resposta. Seu agente obtém o contexto com uma só requisição e dispensa a segunda chamada para buscar cada página.

type escolhe a busca. standard é o padrão. pro cobre mais da web e escolhe os trechos com mais cuidado para perguntas que precisam de várias fontes, e responde em cerca de quatro segundos. Os operadores de busca restringem as duas: site:, -site:, after: e before:. Uma busca que ainda está em andamento após 30 segundos retorna a tarefa, e os resultados são lidos em GET /v1/async/task/{id}.

Com 200 perguntas do FRAMES em 15 de novembro de 2026, um modelo que respondia só com os resultados do Search acertou 66,5% das vezes, e 68,5% com o Pro Search. O método e a comparação completa estão na página do Search: https://querying.ai/agent-search

Precisão das respostas no FRAMES em relação ao preço por 1.000 buscas: querying.ai Search 66,5% a $0,50, Pro Search 68,5% a $2,00, Parallel fast 63,5% a $1,00, Parallel advanced 70,0% a $5,00, Exa 68,0% a $7,00, Tavily basic 48,5% a $5,00, Tavily advanced 53,5% a $10,00, Firecrawl 43,5% a $1,20
Custo de 1.000 respostas corretas em 100 perguntas de notícias de empresas: querying.ai Search $0,51, Parallel fast $1,00, Firecrawl $1,26, querying.ai Pro Search $2,02, Parallel advanced $5,00, Tavily basic $5,10, Exa $7,07, Tavily advanced $10,20

Onde ajuda

  • Dê a um agente de código ou de pesquisa busca na web com o texto das páginas em uma só chamada de ferramenta.
  • Baseie as respostas de um chatbot em páginas atuais e mostre a url de cada trecho como fonte.
  • Restrinja uma pesquisa a sites confiáveis com includeDomains, ou a páginas recentes com after:.

Envie a requisição

Envie a requisição com a sua chave de API no cabeçalho Authorization.

curl -X POST https://api.querying.ai/v1/search \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how do heat pumps work in cold climates",
    "type": "pro",
    "numResults": 3,
    "contents": { "text": { "maxCharacters": 500 } }
  }'

Campos da requisição

querystringObrigatório
A busca, até 400 caracteres. Aceita os operadores site:example.com, -site:example.com, after:YYYY-MM-DD e before:YYYY-MM-DD.
typestring
standard ou pro. pro busca mais a fundo para perguntas que precisam de várias fontes. Padrão standard.
numResultsinteger
Quantos resultados retornar, de 1 a 10. Padrão 5.
contents.text.maxCharactersinteger
Caracteres de texto da página que cada resultado traz em text, de 200 a 10.000. Padrão 2.000.
userLocationstring
Código de país de duas letras, para resultados de um só mercado. Deixe de fora para a busca mais rápida, no idioma da busca.
includeDomainsarray
Até 20 nomes de host. Os resultados vêm só desses sites e dos subdomínios deles.
excludeDomainsarray
Até 20 nomes de host cujos resultados ficam de fora.
idempotencyKeystring
Seu próprio ID para a requisição. Cada chave cria uma única tarefa por conta, então um reenvio continua sendo uma tarefa.

Resposta

A resposta, resumida para facilitar a leitura.

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "SEARCH",
    "status": "COMPLETED",
    "createdAt": "…",
    "latencyMs": 4063
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "query": "how do heat pumps work in cold climates",
    "source": "all",
    "type": "pro",
    "results": [
      {
        "url": "https://www.carrier.com/us/en/residential/hvac-resources/heat-pumps/cold-climate-heat-pump/",
        "title": "Cold Climate Heat Pump Systems | Efficient Heating in Extreme …",
        "snippet": "In the winter, heat pumps work in cold weather by extracting thermal energy from the outdoor air and transferring it …",
        "text": "## Do cold climate heat pumps work?\n\nA heat pump is a versatile, year-round system that heats and cools your home by moving heat energy rather than generating it. In the winter, heat pumps work in cold weather by extracting thermal energy from the outdoor air and transferring it indoors.\n\n…",
        "score": 1,
        "publishedDate": "2026-09-15T11:03:00.000Z"
      },
      {
        "url": "https://www.mitsubishicomfort.com/articles/mythbusters-heat-pumps-for-extreme-cold-climates",
        "title": "Heat Pumps in Extreme Cold Climates | Mitsubishi Electric HVAC US",
        "snippet": "In cold climates, heat pumps typically experience a decrease in pressure, refrigerant flow rate and operational …",
        "text": "## Myth: Heat Pumps Are Only for Mild and Warm Climates\n\nHow do they work? In cold climates, heat pumps typically experience a decrease in pressure, refrigerant flow rate and operational capacity. …",
        "score": 0.8333,
        "publishedDate": "2026-10-19T12:06:06.108Z"
      },
      {
        "url": "https://homes.rewiringamerica.org/articles/heating-and-cooling/heat-pumps-cold-weather",
        "title": "Do heat pumps work in cold climates? - Rewiring America",
        "snippet": "…",
        "text": "In heating mode, heat pumps go into reverse and pump heat from the air outside your home to the inside. …",
        "score": 0.6667
      }
    ]
  }
}
task.statusstring
QUEUED, PROCESSING e, no fim, COMPLETED com a resposta ou FAILED com error.
credits.creditsChargedinteger
Créditos cobrados pela tarefa concluída. Uma tarefa que falhou cobra 0.
response.resultsarray
Páginas em ordem de pontuação, cada uma com url, title, snippet, text e score, mais publishedDate e siteName quando a página os declara.
response.results[].textstring
Os trechos da página que respondem à busca, na ordem da página, com títulos como linhas # e itens de lista como linhas -.
response.results[].scorenumber
Relevância de 0 a 1, comparável dentro de uma mesma resposta.

Preço

Os créditos são cobrados quando a busca termina: 0,5 por uma busca standard e 2 por uma busca pro. No plano Max, 1.000 buscas standard custam US$ 0,50. Uma conta nova começa com 500 créditos grátis, o suficiente para 1.000 buscas standard. Os planos estão em https://querying.ai/pricing .

Mais novidades

Receba as novidades

Receba atualizações do produto por e-mail.

Feed RSS