Tavily Search

Tavily · Research & Search
POST /v1/searchWeb search with crawl, extract, and URL mapping for fast, structured retrieval across pages and domains for downstream pipelines.
See Tavily Search pricing and specs or try it in the Playground.
At a glance
| Field | Value |
|---|---|
| Model id | tavily-search |
| Model release date | - |
| Input modalities | Text |
| Output modalities | Text |
| Context window | - |
| Weight precision | - |
| Features | web_search, crawl, extract, map |
| Native inference | No |
| New | No |
| Supported endpoints | POST /v1/search |
Pricing
| Charge | Spec | Rate |
|---|---|---|
| Search (Basic/Fast/Ultra-Fast) | per search | $0.0096 |
| Search (Advanced) | per search | $0.019 |
| Search (Advanced + Answer) | per search | $0.029 |
| Extract (Basic) | per 5 URLs | $0.0096 |
| Extract (Advanced) | per 5 URLs | $0.019 |
| Crawl/Map (basic) | per 10 pages | $0.0096 |
| Crawl/Map (with instructions) | per 10 pages | $0.019 |
Example request
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"}'
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | yes | - | The natural-language search query. |
operation_mode | enum | no | "Search" | Search queries the web. Crawl reads pages from a starting URL. Extract returns the content of the given URLs. Map lists the URLs of a site. · Allowed: Search, Crawl, Extract, Map |
search_depth | enum | no | "basic" | basic = fast and cheap, advanced = deeper crawl per result with full content. · Allowed: basic, advanced, fast, ultra-fast |
search_chunks_per_source | number | no | 3 | Advanced search depth only. Number of relevant content chunks to extract per source. · Range: 1 – 3 |
search_topic | enum | no | "general" | Search topic preset (general, news, finance, etc.). Alias of topic. · Allowed: general, news, finance |
include_answer | boolean | no | false | basic | advanced | false. Returns a synthesized answer alongside the results. |
include_raw_content | boolean | no | false | Include the raw HTML content alongside cleaned text. Search mode only. |
include_images | boolean | no | false | Include image URLs from the search results. |
include_image_descriptions | boolean | no | false | Include AI-generated descriptions of returned images. Search mode only. Requires include_images. |
include_favicon | boolean | no | false | Include the favicon URL of each source. Search mode only. |
auto_parameters | boolean | no | false | Let Tavily auto-pick search_depth and other knobs based on the query. Search mode only. |
max_results | number | no | 5 | Maximum number of results to return (1-20). · Range: 1 – 20 |
time_range | enum | no | - | day | week | month | year. Restrict results to this recency window. · Allowed: day, week, month, year |
start_date | string | no | - | Only include sources published after this date (YYYY-MM-DD). |
end_date | string | no | - | Only include sources published before this date (YYYY-MM-DD). |
country | string | no | - | Two-letter ISO 3166-1 code (US, GB, etc.) for biasing results to a country. |
include_domains | string | no | - | Comma-separated allowlist of domains. Only results from these domains are returned. |
exclude_domains | string | no | - | Comma-separated denylist of domains to filter out. |
topic | enum | no | "general" | Search topic preset. general (default), news (recent news), or finance (markets / business). Also accepted as search_topic. · Allowed: general, news, finance |
days | number | no | - | Recency window for the news topic, in days back from today. · Range: 1 – 365 |
crawl_limit | number | no | 50 | Max number of pages to crawl from the starting URL. · Range: 1 – 100 |
crawl_max_depth | number | no | 1 | Maximum link-depth from the starting URL. · Range: 1 – 5 |
crawl_max_breadth | number | no | 20 | Maximum number of links to follow per page. · Range: 1 – 50 |
crawl_extract_depth | enum | no | "basic" | How deeply to extract content from each crawled page. · Allowed: basic, advanced |
crawl_format | enum | no | "markdown" | Output format for crawled content: markdown or text. · Allowed: markdown, text |
crawl_instructions | string | no | - | Natural-language instructions for what to look for during crawl. |
crawl_chunks_per_source | number | no | - | Number of content chunks to extract from each crawled page. · Range: 1 – 5 |
crawl_select_paths | string | no | - | Comma-separated URL paths to include in the crawl. |
crawl_exclude_paths | string | no | - | Comma-separated URL paths to exclude from the crawl. |
crawl_select_domains | string | no | - | Comma-separated domains the crawl is restricted to. |
crawl_exclude_domains | string | no | - | Comma-separated domains the crawl will skip. |
crawl_allow_external | boolean | no | true | Allow the crawler to follow links to external domains. |
crawl_include_images | boolean | no | false | Include image URLs in the crawl output. |
crawl_include_favicon | boolean | no | false | Include each crawled page’s favicon URL. |
crawl_timeout | number | no | 150 | Crawl timeout in seconds. · Range: 10 – 150 |
extract_depth | enum | no | "basic" | basic | advanced. Advanced extraction reads JavaScript-rendered content. · Allowed: basic, advanced |
extract_format | enum | no | "markdown" | Output format for extracted content: markdown or text. · Allowed: markdown, text |
extract_query | string | no | - | Natural-language query to filter / focus the extracted content. |
extract_chunks_per_source | number | no | - | Number of content chunks to extract from each URL. · Range: 1 – 5 |
extract_include_images | boolean | no | false | Include image URLs in the extract output. |
extract_include_favicon | boolean | no | false | Include the source page’s favicon URL. Extract mode only. |
extract_timeout | number | no | 10 | Extract timeout in seconds. · Range: 1 – 60 |
map_limit | number | no | 50 | Max number of URLs to map from the starting site. · Range: 1 – 100 |
map_depth | number | no | 1 | Maximum link-depth from the starting URL. · Range: 1 – 5 |
map_breadth | number | no | 20 | Maximum number of links to follow per page during mapping. · Range: 1 – 50 |
map_instructions | string | no | - | Natural-language instructions for what URLs to find during mapping. |
map_select_paths | string | no | - | Comma-separated URL paths the map is restricted to. |
map_exclude_paths | string | no | - | Comma-separated URL paths the map will skip. |
map_select_domains | string | no | - | Comma-separated domains the map is restricted to. |
map_exclude_domains | string | no | - | Comma-separated domains the map will skip. |
map_allow_external | boolean | no | true | Allow the mapper to follow links to external domains. |
map_timeout | number | no | 150 | Map timeout in seconds. · Range: 10 – 150 |
disable_formatting | boolean | no | false | Return the results as JSON instead of formatted Markdown. Search mode only. |
Notes
Operations
- Search, Crawl, Extract, Map
Search depths
- basic, advanced, fast, ultra-fast
Topics
- general, news, finance
Machine-readable schema: GET https://api.empiriolabs.ai/v1/models/tavily-search.
