TOOL API

tavily_search

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

search20 credits

Call information

Tool slug: tavily.tavily_search
Provider: Tavily
Average response: 0 ms
Calls in 7 days: 0

Input parameters

queryrequired

Search query

max_results

The maximum number of search results to return

search_depth

The depth of the search. 'basic' for generic results, 'advanced' for more thorough search, 'fast' for optimized low latency with high relevance, 'ultra-fast' for prioritizing latency above all else

topic

Search category. Use 'general' for almost all searches, including current events and requests that combine news with other information. Use 'news' only when the user explicitly asks for news, headlines, or news coverage.

time_range

The time range back from the current date to include in the search results

include_images

Include a list of query-related images in the response

include_image_descriptions

Include a list of query-related images and their descriptions in the response

include_raw_content

Include the cleaned and parsed HTML content of each search result

include_domains

A list of domains to specifically include in the search results, if the user asks to search on specific sites set this to the domain of the site

exclude_domains

List of domains to specifically exclude, if the user asks to exclude a domain set this to the domain of the site

country

Boost search results from a specific country. Must be a full country name (e.g., 'United States', 'Japan', 'Germany'). ISO country codes (e.g., 'us', 'jp') are not supported. Available only if topic is general. See https://docs.tavily.com/documentation/api-reference/search for the full list of supported countries.

include_favicon

Whether to include the favicon URL for each result

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

exact_match

Only return results containing the exact phrase(s) in quotes in your query