# Pesquisa na web para agentes

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

URL: https://apicultura.app/ferramentas/pesquisa-web-ia/
Atualizado em 05/11/2026 (2026-11-05).

## 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](/catalogo/?cat=pesquisa). 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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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:

```json
{ "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

```bash
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](/ferramentas/ferramenta.html?slug=pesquisa-web-ia). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

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