Web Content
Web crawling, URL discovery and page extraction.
Tavily Extract
Extrai conteúdo legível de uma URL ou de um array de URLs. Selecione texto ou Markdown com format. Verifique results e failed_results: uma URL com falha pode ser reportada em uma resposta HTTP bem-sucedida. Defina include_usage para receber informações de uso de recursos; usage.credits não é uma cobrança da Felo.
Referência de preços
- Medição: unidades de resposta medidas.
- Estimativa de referência por requisição: USD 0.024.
- Base de custo unitário: USD 0.008.
- Unidade de recurso:
tavily_credit. - Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.
- As bases de custo não definem o preço final do cliente, inclusive quando forem zero.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- urlsobrigatório
A URL ou as URLs de onde extrair conteúdo. Uma única string de URL e um array de strings de URL são aceitos.
- Tipo: string
A URL ou as URLs de onde extrair conteúdo. Uma única string de URL e um array de strings de URL são aceitos.
- Tipo: integerchunks
_per _source mín:1máx:5Número máximo de trechos relevantes retornados por fonte. Disponível apenas quando query é fornecida.
- Tipo: string enumextract
_depth Profundidade do processo de extração.
valores- basic
- advanced
- Tipo: string enumformat
Formato do conteúdo extraído da página web.
valores- markdown
- text
- Tipo: booleaninclude
_favicon Inclui a URL do favicon de cada resultado.
- Tipo: booleaninclude
_images Inclui uma lista de imagens extraídas das URLs.
- Tipo: booleaninclude
_usage Inclui informações de uso de recursos na resposta. Não são informações de cobrança da Felo.
- Tipo: stringquery
Intenção do usuário para reclassificar trechos de conteúdo extraídos.
- Tipo: number Formato: floattimeoutmín:1máx:60
Tempo máximo em segundos para aguardar a extração de URL. Se omitido, os timeouts padrão dependem de extract_depth: 10 segundos para basic e 30 segundos para advanced.
- Tipo: object200
Resultados de extração retornados com sucesso.
- Tipo: array string[]failed
_results Lista de URLs que não puderam ser processadas.
- Tipo: stringrequest
_id Identificador exclusivo da requisição.
- Tipo: number Formato: floatresponse
_time Tempo em segundos para concluir a requisição.
- Tipo: array object[]results
- faviconTipo: string | null
URL do favicon do conteúdo extraído.
- imagesTipo: array string[]
Imagens extraídas da URL quando include_images é true.
- rawTipo: string
_content Conteúdo bruto extraído da URL.
- titleTipo: string
Título da página extraída.
- urlTipo: string
URL do conteúdo extraído.
- Tipo: objectusage
- creditsTipo: integer
Unidades de recursos consumidas por esta requisição, não USD nem créditos Felo.
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
application/json
curl --request POST https://openapi.felo.ai/v1/beta/tavily/extract \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"urls": ["https://example.com"], "extract_depth": "basic", "format": "text", "include_usage": true}'
{
"results": [
{
"url": "https://example.com",
"title": "Example Domain",
"raw_content": "This domain is for use in documentation examples.",
"images": []
}
],
"failed_results": [],
"response_time": 0.5,
"usage": {
"credits": 1
},
"request_id": "example-extract-request"
}