Pesquisa na web para agentes

Pesquisa na web para agentes: Busca semântica e respostas com citações, pensadas para agentes de IA.

Atualizado em 05/11/2026.

O que é Pesquisa na web para agentes na APIcultura

Acesse Pesquisa na web para agentes pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Busca semântica e respostas com citações, pensadas para agentes de IA. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: Pesquisa e conhecimento. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Endpoint (slug)	O que faz	Preço por chamada	Rota
`pesquisa-web-semantica`	Busca semântica na web	R$ 0,07	`POST /v1/call/pesquisa-web-semantica`
`pesquisa-resposta-citada`	Resposta com citações	R$ 0,05	`POST /v1/call/pesquisa-resposta-citada`
`pesquisa-perplexity`	Busca (Perplexity)	R$ 0,05	`POST /v1/call/pesquisa-perplexity`
`pesquisa-resposta-rapida`	Resposta rápida	R$ 0,09	`POST /v1/call/pesquisa-resposta-rapida`
`pesquisa-web-rapida`	Busca rápida na web	R$ 0,01	`POST /v1/call/pesquisa-web-rapida`
`pesquisa-noticias-recentes`	Notícias recentes	R$ 0,08	`POST /v1/call/pesquisa-noticias-recentes`
`pesquisa-artigos-academicos`	Artigos acadêmicos	R$ 0,45	`POST /v1/call/pesquisa-artigos-academicos`
`pesquisa-arxiv`	Artigos no arXiv	R$ 0,01	`POST /v1/call/pesquisa-arxiv`
`pesquisa-google-academico`	Google Acadêmico	R$ 0,01	`POST /v1/call/pesquisa-google-academico`
`pesquisa-patentes`	Patentes	R$ 0,01	`POST /v1/call/pesquisa-patentes`

Busca semântica na web (`pesquisa-web-semantica`)

Busca na web por significado ou palavra-chave, com conteúdo dos resultados. Preço: R$ 0,07 por chamada.

query (string, obrigatório), ex.: open source vector database written in rust
numResults (integer, opcional), ex.: 5
type (string, opcional), ex.: auto
category (string, opcional)
includeDomains (array[string], opcional)
excludeDomains (array[string], opcional)
startPublishedDate (string, opcional)
endPublishedDate (string, opcional)
userLocation (string, opcional)
contents (object, opcional)

Schema de entrada de pesquisa-web-semantica

{
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "numResults": {
      "type": "number"
    },
    "type": {
      "type": "string",
      "maxLength": 2000
    },
    "category": {
      "type": "string",
      "maxLength": 2000
    },
    "includeDomains": {
      "type": "string",
      "maxLength": 2000
    },
    "excludeDomains": {
      "type": "string",
      "maxLength": 2000
    },
    "startPublishedDate": {
      "type": "string",
      "maxLength": 2000
    },
    "endPublishedDate": {
      "type": "string",
      "maxLength": 2000
    },
    "userLocation": {
      "type": "string",
      "maxLength": 2000
    },
    "contents": {
      "type": "object"
    }
  }
}

Resposta com citações (`pesquisa-resposta-citada`)

Responde uma pergunta com base na web, citando as fontes. Preço: R$ 0,05 por chamada.

query (string, obrigatório), ex.: What year was the HNSW algorithm paper published and by whom?
text (boolean, opcional)
outputSchema (object, opcional)
stream (boolean, opcional)

Schema de entrada de pesquisa-resposta-citada

{
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "text": {
      "type": "boolean"
    },
    "outputSchema": {
      "type": "object"
    },
    "stream": {
      "type": "boolean"
    }
  }
}

Busca (Perplexity) (`pesquisa-perplexity`)

Busca na web com resultados ranqueados. Preço: R$ 0,05 por chamada.

query (string, obrigatório), ex.: IANA reserved example domains
search_type (string, obrigatório), ex.: web
max_results (integer, opcional, padrão 10, mín. 1, máx. 20), ex.: 1
country (string, opcional), ex.: US
search_domain_filter (array[string], opcional)
search_language_filter (array[string], opcional)
search_context_size (string, opcional)

Schema de entrada de pesquisa-perplexity

{
  "required": [
    "query",
    "search_type"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "search_type": {
      "type": "string",
      "maxLength": 2000
    },
    "max_results": {
      "type": "number"
    },
    "country": {
      "type": "string",
      "maxLength": 2000
    },
    "search_domain_filter": {
      "type": "string",
      "maxLength": 2000
    },
    "search_language_filter": {
      "type": "string",
      "maxLength": 2000
    },
    "search_context_size": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Resposta rápida (`pesquisa-resposta-rapida`)

Resposta rápida a uma pergunta usando a web. Preço: R$ 0,09 por chamada.

preset (string, obrigatório), ex.: fast
input (string, obrigatório), ex.: What is example.com used for?
max_steps (integer, obrigatório), ex.: 1
max_output_tokens (integer, obrigatório, mín. 1, máx. 512), ex.: 160

Schema de entrada de pesquisa-resposta-rapida

{
  "required": [
    "preset",
    "input",
    "max_steps",
    "max_output_tokens"
  ],
  "properties": {
    "preset": {
      "type": "string",
      "maxLength": 2000
    },
    "input": {
      "type": "string",
      "maxLength": 2000
    },
    "max_steps": {
      "type": "number"
    },
    "max_output_tokens": {
      "type": "number"
    }
  }
}

Busca rápida na web (`pesquisa-web-rapida`)

Busca na web rápida e barata para agentes. Preço: R$ 0,01 por chamada.

search_queries (array[string], obrigatório), ex.: python requests library
mode (string, obrigatório), ex.: fast
objective (string, opcional), ex.: What is the Python requests library?
max_chars_total (integer, opcional)
session_id (string, opcional)
client_model (string, opcional)
advanced_settings (object, opcional)

Schema de entrada de pesquisa-web-rapida

{
  "required": [
    "search_queries",
    "mode"
  ],
  "properties": {
    "search_queries": {
      "type": "string",
      "maxLength": 2000
    },
    "mode": {
      "type": "string",
      "maxLength": 2000
    },
    "objective": {
      "type": "string",
      "maxLength": 2000
    },
    "max_chars_total": {
      "type": "number"
    },
    "session_id": {
      "type": "string",
      "maxLength": 2000
    },
    "client_model": {
      "type": "string",
      "maxLength": 2000
    },
    "advanced_settings": {
      "type": "object"
    }
  }
}

Notícias recentes (`pesquisa-noticias-recentes`)

Busca notícias recentes sobre um tema. Preço: R$ 0,08 por chamada.

query (string, obrigatório)
topic (string, obrigatório)
max_results (integer, opcional, mín. 1, máx. 20)
search_depth (string, opcional)
include_usage (boolean, opcional)

Schema de entrada de pesquisa-noticias-recentes

{
  "required": [
    "query",
    "topic"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "topic": {
      "type": "string",
      "maxLength": 2000
    },
    "max_results": {
      "type": "number"
    },
    "search_depth": {
      "type": "string",
      "maxLength": 2000
    },
    "include_usage": {
      "type": "boolean"
    }
  }
}

Mais 4 endpoints na tabela acima; os parâmetros seguem o input_schema de cada um.

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "pesquisa-web-semantica", "input": {"query":"open source vector database written in rust","numResults":5,"type":"auto"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/pesquisa-web-semantica \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"open source vector database written in rust","numResults":5,"type":"auto"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,07 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Experimente

Teste no playground interativo: Pesquisa na web para agentes no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. Pesquisa na web para agentes é marca de seus respectivos donos, citada apenas para identificar a integração.