Web Content
Web crawling, URL discovery and page extraction.
Tavily Extract
Extrae contenido legible de una URL o de un array de URLs. Selecciona texto o Markdown con format. Revisa results y failed_results: una URL fallida puede aparecer en una respuesta HTTP correcta. Establece include_usage para recibir información sobre el uso de recursos; usage.credits no es un cargo de Felo.
Referencia de precios
- Medición: unidades de respuesta medidas.
- Estimación de referencia por solicitud: USD 0.024.
- Base de costo unitario: USD 0.008.
- Unidad de recurso:
tavily_credit. - Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.
- Las bases de costo no determinan el precio final del cliente, incluso cuando son cero.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- urlsobligatorio
La URL o las URL de las que extraer contenido. Se aceptan tanto una cadena de URL única como un array de cadenas de URL.
- Tipo: string
La URL o las URL de las que extraer contenido. Se aceptan tanto una cadena de URL única como un array de cadenas de URL.
- Tipo: integerchunks
_per _source mín.:1máx.:5Número máximo de fragmentos relevantes devueltos por fuente. Disponible solo cuando se proporciona query.
- Tipo: string enumextract
_depth Profundidad del proceso de extracción.
valores- basic
- advanced
- Tipo: string enumformat
Formato del contenido extraído de la página web.
valores- markdown
- text
- Tipo: booleaninclude
_favicon Incluye la URL del favicon de cada resultado.
- Tipo: booleaninclude
_images Incluye una lista de imágenes extraídas de las URL.
- Tipo: booleaninclude
_usage Incluye información de uso de recursos en la respuesta. No es información de facturación de Felo.
- Tipo: stringquery
Intención del usuario para reclasificar fragmentos de contenido extraídos.
- Tipo: number Formato: floattimeoutmín.:1máx.:60
Tiempo máximo en segundos para esperar la extracción de URL. Si se omite, los tiempos de espera predeterminados dependen de extract_depth: 10 segundos para basic y 30 segundos para advanced.
- Tipo: object200
Resultados de extracción devueltos correctamente.
- Tipo: array string[]failed
_results Lista de URL que no se pudieron procesar.
- Tipo: stringrequest
_id Identificador único de la solicitud.
- Tipo: number Formato: floatresponse
_time Tiempo en segundos que tardó en completarse la solicitud.
- Tipo: array object[]results
- faviconTipo: string | null
URL del favicon del contenido extraído.
- imagesTipo: array string[]
Imágenes extraídas de la URL cuando include_images es true.
- rawTipo: string
_content Contenido sin procesar extraído de la URL.
- titleTipo: string
Título de la página extraída.
- urlTipo: string
URL del contenido extraído.
- Tipo: objectusage
- creditsTipo: integer
Unidades de recursos consumidas por esta solicitud, no USD ni créditos de Felo.
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
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"
}