Web Search
Search public web content with Tavily.
Tavily Search
Busca en la web y devuelve resultados clasificados con títulos, URL y fragmentos de contenido. query es obligatorio. Usa max_results para controlar el número de resultados y search_depth para seleccionar el modo de búsqueda. answer, images y raw content adicionales solo se devuelven cuando se solicitan. 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.016.
- 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.
- Tipo: stringqueryobligatorio
La consulta de búsqueda que se ejecutará con Tavily.
- Tipo: booleanauto
_parameters Configura automáticamente los parámetros de búsqueda según el contenido de la query.
- Tipo: integerchunks
_per _source mín.:1máx.:3Número máximo de fragmentos relevantes devueltos por fuente.
- Tipo: string enumcountry
Aumenta la relevancia de los resultados de búsqueda de un país específico. Disponible solo cuando topic es general.
valores- afghanistan
- albania
- algeria
- andorra
- angola
- Tipo: string Formato: dateend
_date Devuelve resultados anteriores a la fecha de finalización especificada.
- Tipo: array string[] …150exclude
_domains Lista de dominios que se deben excluir específicamente de los resultados de búsqueda.
- include
_answer Incluye una respuesta generada por LLM. true usa el modo de respuesta predeterminado; basic o advanced selecciona el modo de generación de respuesta.
- Tipo: boolean
Incluye una respuesta generada por LLM. true usa el modo de respuesta predeterminado; basic o advanced selecciona el modo de generación de respuesta.
- Tipo: array string[] …300include
_domains Lista de dominios que se deben incluir específicamente en los resultados de búsqueda.
- Tipo: booleaninclude
_favicon Incluye la URL del favicon de cada resultado.
- Tipo: booleaninclude
_image _descriptions Añade texto descriptivo para cada imagen cuando include_images es true.
- Tipo: booleaninclude
_images Realiza una búsqueda de imágenes e incluye los resultados.
- include
_raw _content Incluye contenido limpio y analizado para cada resultado de búsqueda. true o markdown devuelve markdown; text devuelve texto sin formato y puede aumentar la latencia.
- Tipo: boolean
Incluye contenido limpio y analizado para cada resultado de búsqueda. true o markdown devuelve markdown; text devuelve texto sin formato y puede aumentar la latencia.
- Tipo: booleaninclude
_usage Incluye información de uso de recursos en la respuesta. No es información de facturación de Felo.
- Tipo: integermax
_results mín.:0máx.:20Número máximo de resultados de búsqueda que se devolverán.
- Tipo: booleansafe
_search Filtra contenido para adultos o no seguro de los resultados de búsqueda. Solo Enterprise; no se admite cuando search_depth es fast o ultra-fast.
- Tipo: string enumsearch
_depth Controla el equilibrio entre latencia y relevancia. advanced ofrece la mayor relevancia con mayor latencia y costo; basic es equilibrado; fast y ultra-fast optimizan para una menor latencia.
valores- advanced
- basic
- fast
- ultra
-fast
- Tipo: string Formato: datestart
_date Devuelve resultados posteriores a la fecha de inicio especificada.
- Tipo: string enumtime
_range Intervalo de tiempo para filtrar resultados según la fecha de publicación.
valores- day
- week
- month
- year
- d
- w
- m
- y
- Tipo: string enumtopic
Categoría de la búsqueda.
valores- general
- news
- finance
- Tipo: object200
Resultados de búsqueda devueltos correctamente.
- Tipo: string | nullanswer
Una respuesta breve generada por LLM. Presente como null cuando include_answer es false o no se genera ninguna respuesta.
- Tipo: array object[]images
- descriptionTipo: string
Descripción de la imagen.
- urlTipo: string
URL de la imagen.
- Tipo: stringquery
La consulta de búsqueda ejecutada.
- 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
- contentTipo: string
Fragmento de contenido del resultado de búsqueda.
- faviconTipo: string | null
URL del favicon del resultado de búsqueda.
- rawTipo: string | null
_content Contenido de origen limpio y analizado. Null a menos que se solicite include_raw_content o no haya contenido sin procesar disponible.
- scoreTipo: number Formato: float
Puntuación de relevancia del resultado de búsqueda.
- titleTipo: string
Título del resultado de búsqueda.
- urlTipo: string
URL del resultado de búsqueda.
- 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/search \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"query": "Python official documentation", "search_depth": "basic", "max_results": 2, "include_usage": true}'
{
"query": "Python official documentation",
"answer": null,
"images": [],
"results": [
{
"title": "Python Documentation",
"url": "https://docs.python.org/3/",
"content": "Documentation for the Python programming language.",
"score": 0.98,
"raw_content": null
}
],
"response_time": 1.2,
"usage": {
"credits": 1
},
"request_id": "example-search-request"
}