# Busca na Web

Encontre páginas da web e retorne títulos, links e trechos.

Pesquise na web e receba páginas de origem para seu aplicativo processar. Para uma resposta gerada com fontes, use [Chat](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-chat.md).

Todos os exemplos usam `FELO_API_KEY` a partir da [visão geral](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-overview.md). As chamadas usam **saldo da plataforma**, não créditos Pro da Felo. Os exemplos de resposta são ilustrativos; o conteúdo ao vivo e os campos opcionais variam.

## Endpoint

`POST /api/v1/data/web/search`

## Solicitação

| Campo | Tipo | Obrigatório | Significado |
|---|---|---|---|
| `query` | string | Sim | Consulta de busca, 1–4.000 caracteres |
| `count` | integer | Não | Quantidade de resultados solicitada, 1–50; padrão 10 |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"retrieval augmented generation","count":3}'
```

## Resposta

HTTP 200 retorna os resultados na raiz do JSON:

```json
{
  "resources": [
    {"title":"Example guide","link":"https://example.com/guide","snippet":"An introduction to retrieval augmented generation."}
  ],
  "total": 1
}
```

| Campo | Significado |
|---|---|
| `resources` | Páginas retornadas; cada uma tem `title`, `link` e `snippet` |
| `total` | Número de recursos retornados, não o número total de páginas na internet |

`count` é a quantidade solicitada, não uma garantia de que existam resultados suficientes correspondentes. Este endpoint não tem parâmetro de cursor. Para ler uma fonte na íntegra, passe o `link` dela para [Leitura da Web](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-web-read.md).

## Cobrança e falhas

A unidade de cobrança é uma solicitação (`web.search`), não uma página retornada. Leia os [preços atuais](https://openapi.felo.ai/api/v1/data/prices). Um erro de saldo ou de cota deve ser tratado separadamente de um resultado vazio bem-sucedido; consulte [Cobrança e Erros](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-billing.md).