Execute a search query using Tavily Search.
post_tavily_searchSearch the web and get back ranked results with the page text already extracted, so there is no second call to fetch content. query is required. Returns results[] with url, title, content (the extracted excerpt), score and optionally raw_content, alongside query, images, response_time and request_id; set include_answer to also get a one-paragraph answer. Filter with topic (general/news/finance), time_range or explicit start_date/end_date, and trade cost against depth with search_depth. Measured at roughly 6 seconds for 2 results. This is the default choice for open-web research, and the only search here that returns ranked results and page text in one call. Reach past it when: you already know the URLs — post_tavily_extract is cheaper and exact; the query is a description rather than keywords — post_exa_search matches on meaning; you want a written answer rather than a list to iterate — post_perplexity_sonar; you want peer-reviewed papers — post_scholar_search_scholar.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The search query to execute with Tavily. | |
| topic | No | Category of the search. | general |
| country | No | Boost search results from a specific country. Available only when topic is general. | |
| end_date | No | Return results before the specified end date. | |
| start_date | No | Return results after the specified start date. | |
| time_range | No | Time range to filter results based on publish date. | |
| max_results | No | Maximum number of search results to return. | |
| safe_search | No | Filter out adult or unsafe content from search results. Enterprise only; not supported when search_depth is fast or ultra-fast. | |
| search_depth | No | Controls the latency vs. relevance tradeoff. advanced gives the highest relevance with higher latency and cost; basic is balanced; fast and ultra-fast optimize for lower latency. | basic |
| include_usage | No | Include credit usage information in the response. | |
| include_answer | No | Include an LLM-generated answer. true uses the default answer mode; basic or advanced selects the answer generation mode. | |
| include_images | No | Perform an image search and include results. | |
| auto_parameters | No | Automatically configure search parameters based on query content. | |
| exclude_domains | No | List of domains to specifically exclude from the search results. | |
| include_domains | No | List of domains to specifically include in the search results. | |
| include_favicon | No | Include the favicon URL for each result. | |
| chunks_per_source | No | Maximum number of relevant chunks returned per source. | |
| include_raw_content | No | Include cleaned and parsed content for each search result. true or markdown returns markdown; text returns plain text and may increase latency. | |
| include_image_descriptions | No | Add descriptive text for each image when include_images is true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||