# Leitura da Web

Leia uma URL como Markdown, texto, HTML ou captura de tela.

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).