Felo API PlatformFelo API Platform

Felo 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

CampoTipoObrigatórioSignificado
urlstringSimURL HTTP ou HTTPS da página
formatsarray de stringsNãoExatamente um de MARKDOWN, TEXT, HTML, SCREENSHOT; o padrão é Markdown
modestringNãoquality (padrão), fast ou auto
timeoutintegerNãoTempo limite em milissegundos, 1–60.000; padrão 30.000
totalTimeoutintegerNãoTempo 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.

Precisa de ajuda?