Changelog
auto_parameters (BETA)- Boolean default:
false - When
auto_parametersis 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_resultsmust always be set manually, as they directly affect response size. - Note:
search_depthmay be automatically set toadvancedwhen it’s likely to improve results. This uses 2 API credits per request. To avoid the extra cost, you can explicitly setsearch_depthtobasic. - Currently in BETA.
/usage endpointEasily 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 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.
- 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.
format parameter- Type:
enum<string> - Default:
markdown - The format of the extracted web page content.
markdownreturns content in markdown format.textreturns plain text and may increase latency. - Available options:
markdown,text
search_depth and chunks_per_sourceparameterssearch_depth- Type:
enum<string> - Default:
basic - The depth of the search.
advancedsearch is tailored to retrieve the most relevant sources and content snippets for your query, whilebasicsearch provides generic content snippets from each source. - A
basicsearch costs 1 API Credit, while anadvancedsearch 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_sourceto 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_depthisadvanced. - Required range:
1 < x < 3
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.
Tavily Crawl is ideal for use cases such as large-scale content aggregation, competitive research, knowledge base creation, and more.
For full details and API usage examples, see the Tavily Crawl API reference.