tavily_search
Search the web for current information on any topic. Returns snippets and source URLs for news, facts, or data.
Instructions
Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query | |
| topic | No | The category of the search. This will determine which of our agents will be used for the search | general |
| country | No | 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. | |
| end_date | No | Will return all results before the specified end date. Required to be written in the format YYYY-MM-DD | |
| start_date | No | Will return all results after the specified start date. Required to be written in the format YYYY-MM-DD. | |
| time_range | No | The time range back from the current date to include in the search results | |
| exact_match | No | Only return results containing the exact phrase(s) in quotes in your query | |
| max_results | No | The maximum number of search results to return | |
| search_depth | No | 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 | basic |
| include_images | No | Include a list of query-related images in the response | |
| exclude_domains | No | List of domains to specifically exclude, if the user asks to exclude a domain set this to the domain of the site | |
| include_domains | No | 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 | |
| include_favicon | No | Whether to include the favicon URL for each result | |
| include_raw_content | No | Include the cleaned and parsed HTML content of each search result | |
| include_image_descriptions | No | Include a list of query-related images and their descriptions in the response |