Tavily icon

Tavily

Search the web, extract page content, crawl and map websites, and run in-depth research with Tavily

Actions6

Search → Query

AI-generated

Summary

Search the web with Tavily for a required query and return ranked results with content snippets. In tool mode, you can let the model choose search settings or set them yourself; use Options to add further filters and result details.

Inputs

  • Query (required) — The web search query.
  • Topic — In tool mode, select general, news, or finance, or let the model decide.
  • Time Range — In tool mode, filter by day, week, month, or year, or let the model decide. The model input can also use an empty string for no date restriction.
  • Search Depth — In tool mode, choose basic, advanced, fast, or ultra-fast, or let the model decide. Advanced costs two credits per search instead of one.
  • Include Answer — In tool mode, choose none, basic, or advanced to control whether Tavily includes a generated answer, or let the model decide.
  • Include Domains — In tool mode, comma-separated domains to include; these are combined with domains set in Options.
  • Exclude Domains — In tool mode, comma-separated domains to exclude; these are combined with domains set in Options.
  • Simplify — In tool mode, return a simplified response by default, or disable this to return Tavily's raw response.
  • Options — Additional search settings include result limit, topic, search depth, time range and date bounds, included or excluded domains, exact phrase matching, image search, raw content, favicon, usage, answer, and automatic parameter selection. Domain lists may be entered as multiple values.

Output shape

One item containing the search response object.

In tool mode, simplified output retains non-empty query, answer, follow-up questions, images, and usage fields, plus results with non-empty title, URL, content, score, publication date, raw content, and favicon fields. If Simplify is disabled, the raw Tavily response is returned. In non-tool mode, the raw response is returned.

Examples

Example 1: Find recent news about a product launch from selected sites.

Set Query to a specific search phrase, Topic to news, Time Range to month, and Include Domains to comma-separated domains such as reuters.com, techcrunch.com.

Links

Discussion