# Felo Leitura da Web

POST /api/v1/data/web/read

Leia uma página específica da web em um formato que seu aplicativo possa consumir.

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/read`

## Solicitação

| Campo | Tipo | Obrigatório | Significado |
|---|---|---|---|
| `url` | string | Sim | URL HTTP ou HTTPS da página |
| `formats` | array de strings | Não | Exatamente um de `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; o padrão é Markdown |
| `mode` | string | Não | `quality` (padrão), `fast` ou `auto` |
| `timeout` | integer | Não | Tempo limite em milissegundos, 1–60.000; padrão 30.000 |
| `totalTimeout` | integer | Não | Tempo limite total em milissegundos, 1–60.000; padrão `timeout` |

Escolha um formato de saída por solicitação; não envie os quatro no mesmo array.

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/read" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","formats":["MARKDOWN"],"mode":"quality","timeout":30000}'
```

## Resposta

HTTP 200 retorna o campo de conteúdo selecionado na raiz do JSON. Uma resposta em Markdown pode ser assim:

```json
{
  "title": "Example Domain",
  "markdown": "# Example Domain\n\nThis domain is for use in documentation examples.",
  "metadata": {}
}
```

Leia `markdown`, `text`, `html` ou `screenshot` de acordo com o formato solicitado. Outros metadados são opcionais; não exija que todos os campos de formato estejam presentes. Consulte o esquema `WebReadResponse` na [definição OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json) para a resposta completa.

## Cobrança e falhas

`web.read` é cobrado por solicitação. Um timeout não é uma página vazia: verifique o status HTTP antes de usar o corpo. Não mude para solicitações repetidas e rápidas após um timeout; siga [Cobrança e Erros](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-billing.md).