Tavily Search
Tavily · Research & Search
POST /v1/searchBúsqueda web con rastreo, extracción y mapeo de URL para una recuperación rápida y estructurada entre páginas y dominios para las canalizaciones posteriores.
A simple vista
| Campo | Valor |
|---|---|
| ID de modelo | tavily-search |
| Fecha de lanzamiento del modelo | - |
| Modalidades de entrada | Texto |
| Modalidades de salida | Texto |
| Ventana de contexto | - |
| Precisión del peso | - |
| Características | web_search, rastrear, extraer, mapear |
| Inferencia nativa | No |
| Nuevo | No |
| Puntos finales soportados | POST /v1/search |
Precios
| Carga | Especificaciones | Tarifa |
|---|---|---|
| Búsqueda (Basic/Fast/Ultra-Rápido) | por búsqueda | $0.0096 |
| Búsqueda (Avanzado) | por búsqueda | $0.019 |
| Buscar (Avanzado + Responder) | por búsqueda | $0.029 |
| Extracto (Básico) | por 5 URLs | $0.0096 |
| Extracto (Avanzado) | por 5 URLs | $0.019 |
| Crawl/Map (básico) | por cada 10 páginas | $0.0096 |
Solicitud de ejemplo
$ curl https://api.empiriolabs.ai/v1/search \ > -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \ > -H 'Content-Type: application/json' \ > -d '{"model": "tavily-search", "query": "latest LLM benchmarks 2026"}'
Parámetros
| Parámetro | Tipo | Obligatorio | Default | Descripción |
|---|---|---|---|---|
query | Cuerda | Sí | - | La consulta de búsqueda en lenguaje natural. |
operation_mode | enum | no | "Search" | Búsqueda | extraer | gatear | Mapa. Determina qué endpoint de Tavily se ejecuta. · Permitidos: Search, Crawl, Extract, Map |
search_depth | enum | no | "basic" | Básico = rápido y barato, avanzado = rastreo más profundo por resultado con contenido completo. · Permitidos: basic, advanced |
search_chunks_per_source | Número | no | 3 | Número de fragmentos de contenido relevantes para extraer por fuente. · Rango: 1 – 3 |
search_topic | enum | no | "general" | Predefinido de temas de búsqueda (general, noticias, finanzas, etc.). Alias del tema. · Permitidos: general, news, finance |
include_answer | Booleano | no | Cierto | básico | avanzado | falso. Devuelve una respuesta sintetizada junto con los resultados. |
include_raw_content | Booleano | no | falso | Incluye el contenido HTML en bruto junto al texto limpio. |
include_images | Booleano | no | falso | Incluye las URLs de las imágenes de los resultados de búsqueda. |
include_image_descriptions | Booleano | no | falso | Incluye descripciones generadas por IA de las imágenes devueltas. |
include_favicon | Booleano | no | falso | Incluye la URL de favicon de cada fuente. |
auto_parameters | Booleano | no | falso | Deja que Tavily seleccione automáticamente search_depth y otros botones según la consulta. |
max_results | Número | no | 5 | Número máximo de resultados por devolver (1-50). · Rango: 1 – 20 |
time_range | enum | no | - | día | semana | mes | año. Limita los resultados a esta ventana de recencia. · Permitidos: day, week, month, year |
start_date | Cuerda | no | - | Solo incluye fuentes publicadas después de esta fecha (AAAAA-MM-DD). |
end_date | Cuerda | no | - | Solo incluye fuentes publicadas antes de esta fecha (AAAAAA-MM-DD). |
country | Cuerda | no | - | Código ISO 3166-1 de dos letras (EE. UU., Reino Unido, etc.) para sesgar resultados hacia un país. |
include_domains | Cuerda | no | - | Lista de dominios con comas separada por comas. Solo se devuelven los resultados de estos dominios. |
exclude_domains | Cuerda | no | - | Lista de denegación separada por comas de dominios para filtrar. |
topic | enum | no | "general" | Preajuste de tema de búsqueda. General (impago), noticias (noticias recientes) o finanzas (mercados / negocios). También aceptado como search_topic. · Permitidos: general, news, finance |
days | Número | no | - | Ventana de actualidad para el tema de la noticia, en unos días desde hoy. · Rango: 1 – 365 |
crawl_limit | Número | no | 10 | Número máximo de páginas para rastrear desde la URL inicial. · Rango: 1 – 500 |
crawl_max_depth | Número | no | 1 | Profundidad máxima de enlace desde la URL inicial. · Rango: 1 – 5 |
crawl_max_breadth | Número | no | 20 | Número máximo de enlaces a seguir por página. · Rango: 1 – 50 |
crawl_extract_depth | enum | no | "basic" | Hasta qué punto extraer contenido de cada página rastreada. · Permitidos: basic, advanced |
crawl_format | enum | no | "markdown" | Formato de salida para contenido rastreado (markdown | texto | HTML). · Permitidos: markdown, text |
crawl_instructions | Cuerda | no | - | Instrucciones en lenguaje natural sobre qué buscar durante el gateo. |
crawl_chunks_per_source | Número | no | - | Número de fragmentos de contenido para extraer de cada página rastreada. · Rango: 1 – 5 |
crawl_select_paths | Cuerda | no | - | Rutas de URL separadas por comas para incluir en el rastreo. |
crawl_exclude_paths | Cuerda | no | - | Rutas de URL separadas por comas para excluirlas del rastreo. |
crawl_select_domains | Cuerda | no | - | Dominios separados por comas a los que el rastreo está restringido. |
crawl_exclude_domains | Cuerda | no | - | Dominios separados por comas que el rastreo se omitirá. |
crawl_allow_external | Booleano | no | falso | Permite que el rastreador siga enlaces a dominios externos. |
crawl_include_images | Booleano | no | falso | Incluye las URLs de las imágenes en la salida de rastreo. |
crawl_include_favicon | Booleano | no | falso | Incluye la URL de favicon de cada página rastreada. |
crawl_timeout | Número | no | 60 | Tiempo muerto de arrastre en segundos. · Rango: 5 – 300 |
extract_depth | enum | no | "basic" | básico | avanzado. La extracción avanzada lee contenido renderizado en JavaScript. · Permitidos: basic, advanced |
extract_format | enum | no | "markdown" | Formato de salida para contenido extraído (markdown | texto | HTML). · Permitidos: markdown, text |
extract_query | Cuerda | no | - | Consulta en lenguaje natural para filtrar o enfocar el contenido extraído. |
extract_chunks_per_source | Número | no | - | Número de bloques de contenido para extraer de cada URL. · Rango: 1 – 5 |
extract_include_images | Booleano | no | falso | Incluye las URLs de las imágenes en la salida de extracción. |
extract_include_favicon | Booleano | no | falso | Incluye la URL de favicon de la página de origen. |
extract_timeout | Número | no | 10 | Extrae el tiempo de espera en segundos. · Rango: 1 – 60 |
map_limit | Número | no | 50 | Número máximo de URLs para mapear desde el sitio de inicio. · Rango: 1 – 100 |
map_depth | Número | no | 1 | Profundidad máxima de enlace desde la URL inicial. · Rango: 1 – 5 |
map_breadth | Número | no | 20 | Número máximo de enlaces a seguir por página durante el mapeo. · Rango: 1 – 50 |
map_instructions | Cuerda | no | - | Instrucciones en lenguaje natural sobre qué URLs encontrar durante el mapeo. |
map_select_paths | Cuerda | no | - | Rutas de URL separadas por comas a las que el mapa está restringido. |
map_exclude_paths | Cuerda | no | - | Rutas de URL separadas por comas que el mapa se omitirá. |
map_select_domains | Cuerda | no | - | Dominios separados por comas a los que el mapa está restringido. |
map_exclude_domains | Cuerda | no | - | Dominios separados por comas que el mapa se omitirá. |
map_allow_external | Booleano | no | falso | Permite que el mapeador siga enlaces a dominios externos. |
map_timeout | Número | no | 60 | Tiempo límite del mapa en segundos. · Rango: 5 – 300 |
disable_formatting | Booleano | no | falso | Salta el formato EmpirioLabs Markdown (Fuentes / Resultados / bloques de código añadidos por el renderizador). El JSON en bruto de Tavily ascendente se devuelve para usuarios avanzados / agentes. |
Notas
Operaciones
- Buscar, rastrear, extraer, mapear
Profundidades de búsqueda
- Básico, avanzado, rápido, ultrarrápido
Temas
- General, Noticias, Finanzas
Machine-legible esquema: GET https://api.empiriolabs.ai/v1/models/tavily-search.