Tavily Search
Tavily · Research & Search
POST /v1/searchBusca na web com rastreamento, extração e mapeamento de URL para recuperação rápida e estruturada entre páginas e domínios para pipelines posteriores.
De um olhar
| Campo | Valor |
|---|---|
| ID do modelo | tavily-search |
| Data de lançamento do modelo | - |
| Modalidades de entrada | Texto |
| Modalidades de saída | Texto |
| Janela de contexto | - |
| Precisão do peso | - |
| Características | web_search, rastejar, extrair, mapear |
| Inferência nativa | Não |
| Novo | Não |
| Endpoints suportados | POST /v1/search |
Precificação
| Carga | Especificação | Taxa |
|---|---|---|
| Busca (Basic/Fast/Ultra-Rápido) | por busca | $0.0096 |
| Busca (Avançado) | por busca | $0.019 |
| Busca (Avançado + Resposta) | por busca | $0.029 |
| Extrato (Básico) | por 5 URLs | $0.0096 |
| Extrato (Avançado) | por 5 URLs | $0.019 |
| Crawl/Map (básico) | por 10 páginas | $0.0096 |
Exemplo de pedido
$ 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 | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
query | String | sim | - | A consulta de busca em linguagem natural. |
operation_mode | enum | Não | "Search" | Procurar | extrato | rasteje | Mapa. Determina qual endpoint Tavily roda. · Permitido: Search, Crawl, Extract, Map |
search_depth | enum | Não | "basic" | básico = rápido e barato, avançado = rastreamento mais profundo por resultado com conteúdo completo. · Permitido: basic, advanced |
search_chunks_per_source | Número | Não | 3 | Número de blocos de conteúdo relevantes para extrair por fonte. · Distribuição: 1 – 3 |
search_topic | enum | Não | "general" | Pesquisa no tópico preset (geral, notícias, finanças, etc.). Pseudônimo do assunto. · Permitido: general, news, finance |
include_answer | Booleano | Não | Verdade | básico | avançado | falso. Retorna uma resposta sintetizada junto com os resultados. |
include_raw_content | Booleano | Não | falso | Inclua o conteúdo HTML bruto junto com o texto limpo. |
include_images | Booleano | Não | falso | Inclua URLs de imagens dos resultados de busca. |
include_image_descriptions | Booleano | Não | falso | Inclua descrições geradas por IA das imagens retornadas. |
include_favicon | Booleano | Não | falso | Inclua a URL do favicon de cada fonte. |
auto_parameters | Booleano | Não | falso | Deixe Tavily selecionar automaticamente search_depth e outros botões com base na consulta. |
max_results | Número | Não | 5 | Número máximo de resultados a serem retornados (1-50). · Alcance: 1 – 20 |
time_range | enum | Não | - | dia | semana | mês | ano. Restringa os resultados a essa janela de recência. · Permitido: day, week, month, year |
start_date | String | Não | - | Inclua apenas fontes publicadas após essa data (YYY-MM-DD). |
end_date | String | Não | - | Inclua apenas fontes publicadas antes desta data (YYY-MM-DD). |
country | String | Não | - | Código ISO 3166-1 de duas letras (EUA, GB, etc.) para enviesamento de resultados para um país. |
include_domains | String | Não | - | Lista de domínios separada por vírgula. Apenas os resultados desses domínios são retornados. |
exclude_domains | String | Não | - | Lista de negação separada por vírgulas de domínios para filtrar. |
topic | enum | Não | "general" | Predefinição de tópico de busca. geral (calote), notícias (notícias recentes) ou finanças (mercados / negócios). Também aceito como search_topic. · Permitido: general, news, finance |
days | Número | Não | - | Janela de recência para o tema das notícias, em dias atrás a partir de hoje. · Alcance: 1 – 365 |
crawl_limit | Número | Não | 10 | Número máximo de páginas para rastrear a partir da URL inicial. · Alcance: 1 – 500 |
crawl_max_depth | Número | Não | 1 | Profundidade máxima do link a partir da URL inicial. · Alcance: 1 – 5 |
crawl_max_breadth | Número | Não | 20 | Número máximo de links a seguir por página. · Intervalo: 1 – 50 |
crawl_extract_depth | enum | Não | "basic" | Quão profundamente extrair conteúdo de cada página rastreada. · Permitido: basic, advanced |
crawl_format | enum | Não | "markdown" | Formato de saída para conteúdo rastreado (markdown | texto | html). · Permitido: markdown, text |
crawl_instructions | String | Não | - | Instruções em linguagem natural sobre o que observar durante o rastejo. |
crawl_chunks_per_source | Número | Não | - | Número de blocos de conteúdo para extrair de cada página rastreada. · Alcance: 1 – 5 |
crawl_select_paths | String | Não | - | Caminhos de URL separados por vírgulas para incluir no rastreamento. |
crawl_exclude_paths | String | Não | - | Caminhos de URL separados por vírgulas para excluir do rastreamento. |
crawl_select_domains | String | Não | - | Domínios separados por vírgulas aos quais o rastreamento é restrito. |
crawl_exclude_domains | String | Não | - | Domínios separados por vírgulas que o rastreamento pula. |
crawl_allow_external | Booleano | Não | falso | Permita que o rastreador siga links para domínios externos. |
crawl_include_images | Booleano | Não | falso | Inclua URLs de imagem na saída do rastreamento. |
crawl_include_favicon | Booleano | Não | falso | Inclua a URL do favicon de cada página rastreada. |
crawl_timeout | Número | Não | 60 | Tempo de descanso do rastejo em segundos. · Alcance: 5 – 300 |
extract_depth | enum | Não | "basic" | básico | avançado. Extração avançada lê conteúdo renderizado em JavaScript. · Permitido: basic, advanced |
extract_format | enum | Não | "markdown" | Formato de saída para conteúdo extraído (markdown | texto | html). · Permitido: markdown, text |
extract_query | String | Não | - | Consulta em linguagem natural para filtrar/focar o conteúdo extraído. |
extract_chunks_per_source | Número | Não | - | Número de blocos de conteúdo para extrair de cada URL. · Alcance: 1 – 5 |
extract_include_images | Booleano | Não | falso | Inclua URLs de imagem na saída de extração. |
extract_include_favicon | Booleano | Não | falso | Inclua a URL do favicon da página fonte. |
extract_timeout | Número | Não | 10 | Extrai o tempo de espera em segundos. · Alcance: 1 – 60 |
map_limit | Número | Não | 50 | Número máximo de URLs para mapear a partir do site inicial. · Intervalo: 1 – 100 |
map_depth | Número | Não | 1 | Profundidade máxima do link a partir da URL inicial. · Alcance: 1 – 5 |
map_breadth | Número | Não | 20 | Número máximo de links a seguir por página durante o mapeamento. · Intervalo: 1 – 50 |
map_instructions | String | Não | - | Instruções em linguagem natural sobre quais URLs encontrar durante o mapeamento. |
map_select_paths | String | Não | - | Caminhos de URL separados por vírgulas aos quais o mapa é restrito. |
map_exclude_paths | String | Não | - | Caminhos de URL separados por vírgulas que o mapa pulará. |
map_select_domains | String | Não | - | Domínios separados por vírgulas aos quais o mapa é restrito. |
map_exclude_domains | String | Não | - | Domínios separados por vírgulas que o mapa irá pular. |
map_allow_external | Booleano | Não | falso | Permita que o mapeador siga links para domínios externos. |
map_timeout | Número | Não | 60 | Tempo limite do mapa em segundos. · Alcance: 5 – 300 |
disable_formatting | Booleano | Não | falso | Pule a formatação EmpirioLabs Markdown (Fontes / Resultados / blocos de código adicionados pelo renderizador). O JSON bruto a montante de Tavily é retornado para usuários avançados / agentes. |
Notas
Operações
- Buscar, Rastrear, Extrair, Mapear
Profundidades de busca
- Básico, Avançado, Rápido, Ultra-Rápido
Tópicos
- General, Notícias, Finanças
Machine esquema legível: GET https://api.empiriolabs.ai/v1/models/tavily-search.