Leitura da Web
Provedor: Felo · Pago com saldo da plataforma
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. 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.
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:
{
"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 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.