tavily_search

tavily_search

Performs a web search using the Tavily Search API, optimized for LLMs. Use this for broad information gathering, recent events, or when you need diverse web sources. Supports search depth, topic selection, time range filtering, and domain inclusion/exclusion.

Input Schema

Name	Required	Description	Default
`days`	No	The number of days back from the current date to include in the search results (for news topic).
`exclude_domains`	No	A list of domains to specifically exclude from the search results.
`include_answer`	No	Include a short answer to original query, generated by an LLM based on Tavily's search results.
`include_domains`	No	A list of domains to specifically include in the search results.
`include_image_descriptions`	No	When include_images is set to True, this option adds descriptive text for each image.
`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	The search query.
`search_depth`	No	The depth of the search. It can be "basic" or "advanced".	basic
`time_range`	No	The time range back from the current date to include in the search results. Accepted values include "day","week","month","year" or "d","w","m","y".
`topic`	No	The category of the search. Currently: only "general" and "news" are supported.	general

Input Schema (JSON Schema)

{
  "properties": {
    "days": {
      "default": 3,
      "description": "The number of days back from the current date to include in the search results (for news topic).",
      "type": "number"
    },
    "exclude_domains": {
      "default": [],
      "description": "A list of domains to specifically exclude from the search results.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "include_answer": {
      "default": false,
      "description": "Include a short answer to original query, generated by an LLM based on Tavily's search results.",
      "type": "boolean"
    },
    "include_domains": {
      "default": [],
      "description": "A list of domains to specifically include in the search results.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "include_image_descriptions": {
      "default": false,
      "description": "When include_images is set to True, this option adds descriptive text for each image.",
      "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": 5,
      "description": "The maximum number of search results to return.",
      "type": "number"
    },
    "query": {
      "description": "The 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"
    },
    "time_range": {
      "description": "The time range back from the current date to include in the search results. Accepted values include \"day\",\"week\",\"month\",\"year\" or \"d\",\"w\",\"m\",\"y\".",
      "enum": [
        "day",
        "week",
        "month",
        "year",
        "d",
        "w",
        "m",
        "y"
      ],
      "type": "string"
    },
    "topic": {
      "default": "general",
      "description": "The category of the search. Currently: only \"general\" and \"news\" are supported.",
      "enum": [
        "general",
        "news"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Input Schema

Input Schema (JSON Schema)

Other Tools