Include Favicon Parameter
June 2025
include_favicon
parameterYou can now include the favicon URL for each result in the Search, Extract, and Crawl endpoints.
Set the include_favicon
parameter to true
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)false
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.include_answer
, include_raw_content
, and max_results
must always be set manually, as they directly affect response size.search_depth
may be automatically set to advanced
when it’s likely to improve results. This uses 2 API credits per request. To avoid the extra cost, you can explicitly set search_depth
to basic
./usage endpoint
May 2025
/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 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
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.
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
format
parameterenum<string>
markdown
markdown
returns content in markdown format. text
returns plain text and may increase latency.markdown
, text
Advanced Search & Chunks Per Source
April 2025
search_depth
and chunks_per_source
parameterssearch_depth
enum<string>
basic
advanced
search is tailored to retrieve the most relevant sources and content snippets for your query, while basic
search provides generic content snippets from each source.basic
search costs 1 API Credit, while an advanced
search costs 2 API Credits.basic
, advanced
chunks_per_source
chunks_per_source
to define the maximum number of relevant chunks returned per source and to control the content length.<chunk 1> […] <chunk 2> […] <chunk 3>
.search_depth
is advanced
.1 < x < 3
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:
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.