search
Search the web for current information and news using customizable parameters like time range, domain filtering, and result count to gather relevant web content.
Instructions
A powerful web search tool that provides comprehensive, real-time results using Tavily's AI search engine. Returns relevant web content with customizable parameters for result count, content type, and domain filtering. Ideal for gathering current information, news, and detailed web content analysis.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | Boost search results from a specific country. This will prioritize content from the selected country in the search results. Available only if topic is general. Country names MUST be written in lowercase, plain English, with spaces and no underscores. | |
| days | No | The number of days back from the current date to include in the search results. This specifies the time frame of data to be retrieved. Please note that this feature is only available when using the 'news' search topic | |
| end_date | No | Will return all results before the specified end date. Required to be written in the format YYYY-MM-DD | |
| 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_image_descriptions | No | Include a list of query-related images and their descriptions in the response | |
| include_images | No | Include a list of query-related images in the response | |
| include_raw_content | No | Include the cleaned and parsed HTML content of each search result | |
| max_results | No | The maximum number of search results to return | |
| query | Yes | Search query | |
| search_depth | No | The depth of the search. It can be 'basic' or 'advanced' | basic |
| 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. This feature is available for both 'general' and 'news' search topics | |
| topic | No | The category of the search. This will determine which of our agents will be used for the search | general |
Input Schema (JSON Schema)
{
"properties": {
"country": {
"default": "",
"description": "Boost search results from a specific country. This will prioritize content from the selected country in the search results. Available only if topic is general. Country names MUST be written in lowercase, plain English, with spaces and no underscores.",
"type": "string"
},
"days": {
"default": 3,
"description": "The number of days back from the current date to include in the search results. This specifies the time frame of data to be retrieved. Please note that this feature is only available when using the 'news' search topic",
"type": "number"
},
"end_date": {
"default": "",
"description": "Will return all results before the specified end date. Required to be written in the format YYYY-MM-DD",
"type": "string"
},
"exclude_domains": {
"default": [],
"description": "List of domains to specifically exclude, if the user asks to exclude a domain set this to the domain of the site",
"items": {
"type": "string"
},
"type": "array"
},
"include_domains": {
"default": [],
"description": "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",
"items": {
"type": "string"
},
"type": "array"
},
"include_favicon": {
"default": false,
"description": "Whether to include the favicon URL for each result",
"type": "boolean"
},
"include_image_descriptions": {
"default": false,
"description": "Include a list of query-related images and their descriptions in the response",
"type": "boolean"
},
"include_images": {
"default": false,
"description": "Include a list of query-related images in the response",
"type": "boolean"
},
"include_raw_content": {
"default": false,
"description": "Include the cleaned and parsed HTML content of each search result",
"type": "boolean"
},
"max_results": {
"default": 10,
"description": "The maximum number of search results to return",
"maximum": 20,
"minimum": 5,
"type": "number"
},
"query": {
"description": "Search query",
"type": "string"
},
"search_depth": {
"default": "basic",
"description": "The depth of the search. It can be 'basic' or 'advanced'",
"enum": [
"basic",
"advanced"
],
"type": "string"
},
"start_date": {
"default": "",
"description": "Will return all results after the specified start date. Required to be written in the format YYYY-MM-DD.",
"type": "string"
},
"time_range": {
"description": "The time range back from the current date to include in the search results. This feature is available for both 'general' and 'news' search topics",
"enum": [
"day",
"week",
"month",
"year",
"d",
"w",
"m",
"y"
],
"type": "string"
},
"topic": {
"default": "general",
"description": "The category of the search. This will determine which of our agents will be used for the search",
"enum": [
"general",
"news"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}