Tavily Search
Tavily · Research & Search
POST /v1/search通过爬取、提取和URL映射实现快速、结构化的下游管道检索，实现跨页面和域名的快速、结构化检索。
一眼看
| 场地 | 价值 |
|---|---|
| 型号ID | tavily-search |
| 车型发布日期 | - |
| 输入模态 | 正文 |
| 输出模态 | 正文 |
| 上下文窗口 | - |
| 重量精度 | - |
| 特色 | web_search、爬取、提取、映射 |
| 本土推断 | 不 |
| 新 | 不 |
| 支持的端点 | POST /v1/search |
定价
| 冲锋 | 规格 | 速率 |
|---|---|---|
| 搜索（Basic/Fast/超高速） | 每个搜索 | $0.0096 |
| 搜索（高级） | 每个搜索 | $0.019 |
| 搜索（高级+答案） | 每个搜索 | $0.029 |
| 提取物（基础） | 每5个网址 | $0.0096 |
| 提取（高级） | 每5个网址 | $0.019 |
| Crawl/Map（基础） | 每10页 | $0.0096 |
示例请求
$ 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"}'
参数
| 参数 | 类型 | 必修 | 默认 | 描述 |
|---|---|---|---|---|
query | 弦 | 是的 | - | 自然语言搜索查询。 |
operation_mode | 枚举 | 不 | "Search" | 搜索 | 摘录 | 爬行 | 地图。决定哪个端点Tavily运行。·允许：Search，Crawl，Extract，Map |
search_depth | 枚举 | 不 | "basic" | Basic = 快速且便宜，advanced = 每个结果进行更深度的爬行，内容完整。·允许：basic，advanced |
search_chunks_per_source | 人数 | 不 | 3 | 每个来源需要提取的相关内容块数量。·范围：1 – 3 |
search_topic | 枚举 | 不 | "general" | 搜索主题预设（一般、新闻、财经等）。主题的别名。·允许：general，news，finance |
include_answer | 布尔值 | 不 | 确实如此 | 基本 | 高级 | 错误。返回一个综合答案和结果。 |
include_raw_content | 布尔值 | 不 | 错误 | 将原始HTML内容与清理后的文本一同包含。 |
include_images | 布尔值 | 不 | 错误 | 请包含搜索结果中的图片URL。 |
include_image_descriptions | 布尔值 | 不 | 错误 | 包含AI生成的返还图像描述。 |
include_favicon | 布尔值 | 不 | 错误 | 请附上每个来源的同档域名。 |
auto_parameters | 布尔值 | 不 | 错误 | 让Tavily根据查询自动选择search_depth和其他旋钮。 |
max_results | 人数 | 不 | 5 | 返回的最大结果数（1-50）。·范围：1 – 20 |
time_range | 枚举 | 不 | - | 一天 | 一周 | 月份 | 年份。将结果限制在这个最新窗口内。·允许：day，week，month，year |
start_date | 弦 | 不 | - | 仅包含此日期之后发布的资料（YYYY-MM-DD）。 |
end_date | 弦 | 不 | - | 仅包含在此日期之前发布的资料（YYYY-MM-DD）。 |
country | 弦 | 不 | - | ISO 3166-1 的两个字母代码（美国、英国等），用于将结果偏向某一国家。 |
include_domains | 弦 | 不 | - | 逗号分隔的域名允许列表。仅返回这些域的结果。 |
exclude_domains | 弦 | 不 | - | 用逗号分隔的域名过滤。 |
topic | 枚举 | 不 | "general" | 搜索主题预设。综合（违约）、新闻（最新新闻）或金融（市场/商业）。也被接受为search_topic。·允许：general，news，finance |
days | 人数 | 不 | - | 新闻话题的最近窗口，距离今天几天。·范围：1 – 365 |
crawl_limit | 人数 | 不 | 10 | 从起始URL爬取的最大页面数。·范围：1 – 500 |
crawl_max_depth | 人数 | 不 | 1 | 从起始URL获得最大链接深度。·射程：1 – 5 |
crawl_max_breadth | 人数 | 不 | 20 | 每页可追踪的最大链接数。·范围：1 – 50 |
crawl_extract_depth | 枚举 | 不 | "basic" | 从每个爬取页面中提取内容的深度。·允许：basic，advanced |
crawl_format | 枚举 | 不 | "markdown" | 爬取内容的输出格式（markdown | 文本 | html）。·允许：markdown，text |
crawl_instructions | 弦 | 不 | - | 爬行时的自然语言说明。 |
crawl_chunks_per_source | 人数 | 不 | - | 每个爬取页面需要提取的内容块数量。·射程：1 – 5 |
crawl_select_paths | 弦 | 不 | - | 爬行中包含逗号分隔的 URL 路径。 |
crawl_exclude_paths | 弦 | 不 | - | 用逗号分隔的URL路径排除在爬取中。 |
crawl_select_domains | 弦 | 不 | - | 爬行被限制在逗号分隔的领域。 |
crawl_exclude_domains | 弦 | 不 | - | 逗号分隔的域爬行会跳过。 |
crawl_allow_external | 布尔值 | 不 | 错误 | 允许爬虫跟踪指向外部域名的链接。 |
crawl_include_images | 布尔值 | 不 | 错误 | 在爬取输出中包含图片URL。 |
crawl_include_favicon | 布尔值 | 不 | 错误 | 请包含每个爬取页面的收藏网址。 |
crawl_timeout | 人数 | 不 | 60 | 爬行超时只需几秒钟。·范围：5 – 300 |
extract_depth | 枚举 | 不 | "basic" | 基本 | 高级。高级提取读取JavaScript渲染的内容。·允许：basic，advanced |
extract_format | 枚举 | 不 | "markdown" | 提取内容的输出格式（Markdown | 文本 | html）。·允许：markdown，text |
extract_query | 弦 | 不 | - | 自然语言查询以过滤/聚焦提取内容。 |
extract_chunks_per_source | 人数 | 不 | - | 每个URL要提取的内容块数量。·射程：1 – 5 |
extract_include_images | 布尔值 | 不 | 错误 | 在提取输出中包含图片URL。 |
extract_include_favicon | 布尔值 | 不 | 错误 | 请包含源页面的同人网址。 |
extract_timeout | 人数 | 不 | 10 | 几秒钟内提取超时。·范围：1 – 60 |
map_limit | 人数 | 不 | 50 | 从起始网站映射的最大URL数。·范围：1 – 100 |
map_depth | 人数 | 不 | 1 | 从起始URL获得最大链接深度。·射程：1 – 5 |
map_breadth | 人数 | 不 | 20 | 地图绘制过程中每页可追踪的最大链接数。·范围：1 – 50 |
map_instructions | 弦 | 不 | - | 在映射过程中，提供自然语言的URL指引。 |
map_select_paths | 弦 | 不 | - | 映射被限制为逗号分隔的 URL 路径。 |
map_exclude_paths | 弦 | 不 | - | 地图会跳过逗号分隔的URL路径。 |
map_select_domains | 弦 | 不 | - | 映射被限制在逗号分隔的域内。 |
map_exclude_domains | 弦 | 不 | - | 逗号分隔的领域地图会跳过。 |
map_allow_external | 布尔值 | 不 | 错误 | 允许映射者追踪指向外部域名的链接。 |
map_timeout | 人数 | 不 | 60 | 地图超时只需几秒。·范围：5 – 300 |
disable_formatting | 布尔值 | 不 | 错误 | 跳过EmpirioLabs的Markdown格式（源代码/结果/代码块由渲染器添加）。原始的上游 Tavily JSON 会被返回给高级用户/代理。 |
注释
行动
- 搜索、爬取、提取、地图
搜索深度
- 基础、高级、快速、超快
话题
- 综合、新闻、财经
Machine可读模式： GET https://api.empiriolabs.ai/v1/models/tavily-search。