New team roles & permissions
August 2025
New team roles & permissions
August 2025
- Owner
- Full access to all Settings
- Access and ownership of the Billing account
- Admin
- Full access to Settings except ownership transfer
- No access to Billing
- Member
- Limited Settings access (view members only)
- No access to Billing
Extract timeout parameter
August 2025
Extract timeout parameter
August 2025
timeout
parameter- You can now specify a custom timeout for the Extract endpoint to control how long to wait for URL extraction before timing out.
- Type:
number
(float) - Range: Between 1.0 and 60.0 seconds
- Default behavior: If not specified, automatic timeouts are applied based on
extract_depth
: 10 seconds for basic extraction and 30 seconds for advanced extraction. - This gives you fine-grained control over extraction timeouts, allowing you to balance between reliability and speed based on your specific use case.
Start date & end date Parameters
July 2025
Start date & end date Parameters
July 2025
start_date
parameter,end_date
parameter- You can now use both the
start_date
andend_date
parameters in the Search endpoints. start_date
will return all results after the specified start date. Required to be written in the format YYYY-MM-DD.end_date
will return all results before the specified end date. Required to be written in the format YYYY-MM-DD.- Set
start_date
to2025-01-01
andend_date
to2025-04-01
to reiceive results strictly from this time range.
Usage dashboard
July 2025
Usage dashboard
July 2025
Login to your account to view the usage dashboard
The usage dashboard provides the following features to paid users/teams:
- The Usage Graph offers a breakdown of daily usage across all Tavily endpoints with historical data to enable month over month usage and spend comparison.
- The Logs Table offers granular insight into each API request to ensure visibility and traceability with every Tavily interaction.
Include favicon parameter
June 2025
Include favicon parameter
June 2025
include_favicon
parameter- You can now include the favicon URL for each result in the Search, Extract, and Crawl endpoints.
- Set the
include_favicon
parameter totrue
to receive the favicon URL (if available) for each result in the API response. - This makes it easy to display website icons alongside your search, extraction, or crawl results, improving the visual context and user experience in your application.
Auto parameters (BETA)
June 2025
Auto parameters (BETA)
June 2025
auto_parameters
(BETA)- Boolean default:
false
- When
auto_parameters
is enabled, Tavily automatically configures search parameters based on your query’s content and intent. You can still set other parameters manually, and your explicit values will override the automatic ones. - The parameters
include_answer
,include_raw_content
, andmax_results
must always be set manually, as they directly affect response size. - Note:
search_depth
may be automatically set toadvanced
when it’s likely to improve results. This uses 2 API credits per request. To avoid the extra cost, you can explicitly setsearch_depth
tobasic
. - Currently in BETA.
Usage endpoint
May 2025
Usage endpoint
May 2025
/usage
endpoint- Easily check your API usage and plan limits.
Just
GET https://api.tavily.com/usage
with your API key to monitor your account in real time.Country parameter
May 2025
Country parameter
May 2025
country
parameterBoost search results from a specific country.
- This will prioritize content from the selected country in the search results. Available only if
topic
is general
.Make & n8n integrations
May 2025
Make & n8n integrations
May 2025
- Tavily is now available for no-code integration through n8n.
Integrate Tavily with n8n to enhance your workflows with real-time web search and content extraction—without writing code. With Tavily’s powerful search and extraction capabilities, you can seamlessly integrate up-to-date online information into your n8n automations.
- Integrate Tavily with Make without writing a single line of code.
With Tavily’s powerful search and content extraction capabilities, you can seamlessly integrate real-time online information into your Make workflows and automations.
Markdown format
May 2025
Markdown format
May 2025
format
parameter- Type:
enum<string>
- Default:
markdown
- The format of the extracted web page content.
markdown
returns content in markdown format.text
returns plain text and may increase latency. - Available options:
markdown
,text
Advanced search & chunks per source
April 2025
Advanced search & chunks per source
April 2025
search_depth
and chunks_per_source
parameterssearch_depth
- Type:
enum<string>
- Default:
basic
- The depth of the search.
advanced
search is tailored to retrieve the most relevant sources and content snippets for your query, whilebasic
search provides generic content snippets from each source. - A
basic
search costs 1 API Credit, while anadvanced
search costs 2 API Credits. - Available options:
basic
,advanced
- Type:
chunks_per_source
- Chunks are short content snippets (maximum 500 characters each) pulled directly from the source.
- Use
chunks_per_source
to define the maximum number of relevant chunks returned per source and to control the content length. - Chunks will appear in the content field as:
<chunk 1> […] <chunk 2> […] <chunk 3>
. - Available only when
search_depth
isadvanced
. - Required range:
1 < x < 3
Tavily crawl (BETA)
April 2025
Tavily crawl (BETA)
April 2025
- Tavily Crawl enables you to traverse a website like a graph, starting from a base URL and automatically discovering and extracting content from multiple linked pages. With Tavily Crawl, you can:
- Specify the starting URL and let the crawler intelligently follow links to map out the site structure.
- Control the depth and breadth of the crawl, allowing you to focus on specific sections or perform comprehensive site-wide analysis.
- Apply filters and custom instructions to target only the most relevant pages or content types.
- Aggregate extracted content for further analysis, reporting, or integration into your workflows.
- Seamlessly integrate with your automation tools or use the API directly for flexible, programmatic access.
For full details and API usage examples, see the Tavily Crawl API reference.