---
title: Tavily
description: Search and extract information
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="tavily"
  color="#0066FF"
/>

{/* MANUAL-CONTENT-START:intro */}
[Tavily](https://www.tavily.com/) is an AI-powered search API designed specifically for LLM applications. It provides reliable, real-time information retrieval capabilities with features optimized for AI use cases, including semantic search, content extraction, and structured data retrieval.

With Tavily, you can:

- **Perform contextual searches**: Get relevant results based on semantic understanding rather than just keyword matching
- **Extract structured content**: Pull specific information from web pages in a clean, usable format
- **Access real-time information**: Retrieve up-to-date data from across the web
- **Process multiple URLs simultaneously**: Extract content from several web pages in a single request
- **Receive AI-optimized results**: Get search results specifically formatted for consumption by AI systems

In Sim, the Tavily integration enables your agents to search the web and extract information as part of their workflows. This allows for sophisticated automation scenarios that require up-to-date information from the internet. Your agents can formulate search queries, retrieve relevant results, and extract content from specific web pages to inform their decision-making processes. This integration bridges the gap between your workflow automation and the vast knowledge available on the web, enabling your agents to access real-time information without manual intervention. By connecting Sim with Tavily, you can create agents that stay current with the latest information, provide more accurate responses, and deliver more value to users.
{/* MANUAL-CONTENT-END */}


## Usage Instructions

Integrate Tavily into the workflow. Can search the web and extract content from specific URLs. Requires API Key.



## Tools

### `tavily_search`

Perform AI-powered web searches using Tavily

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `query` | string | Yes | The search query to execute \(e.g., "latest AI research papers 2024"\) |
| `max_results` | number | No | Maximum number of results \(1-20, e.g., 5\) |
| `topic` | string | No | Category type: general, news, or finance \(e.g., "news"\) |
| `search_depth` | string | No | Search scope: basic \(1 credit\) or advanced \(2 credits\) \(e.g., "advanced"\) |
| `include_answer` | string | No | LLM-generated response: true/basic for quick answer or advanced for detailed \(e.g., "advanced"\) |
| `include_raw_content` | string | No | Parsed HTML content: true/markdown or text format \(e.g., "markdown"\) |
| `include_images` | boolean | No | Include image search results |
| `include_image_descriptions` | boolean | No | Add descriptive text for images |
| `include_favicon` | boolean | No | Include favicon URLs |
| `chunks_per_source` | number | No | Maximum number of relevant chunks per source \(1-3, default: 3\) |
| `time_range` | string | No | Filter by recency: day/d, week/w, month/m, year/y |
| `start_date` | string | No | Earliest publication date \(YYYY-MM-DD format\) |
| `end_date` | string | No | Latest publication date \(YYYY-MM-DD format\) |
| `include_domains` | string | No | Comma-separated list of domains to whitelist \(e.g., "github.com,stackoverflow.com"\) |
| `exclude_domains` | string | No | Comma-separated list of domains to blacklist \(e.g., "pinterest.com,reddit.com"\) |
| `country` | string | No | Boost results from specified country \(general topic only\) |
| `auto_parameters` | boolean | No | Automatic parameter configuration based on query intent |
| `apiKey` | string | Yes | Tavily API Key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `query` | string | The search query that was executed |
| `results` | array | Ranked search results with titles, URLs, content snippets, and optional metadata |
|   ↳ `title` | string | Result title |
|   ↳ `url` | string | Result URL |
|   ↳ `content` | string | Brief description or content snippet |
|   ↳ `score` | number | Relevance score |
|   ↳ `raw_content` | string | Full parsed HTML content \(if requested\) |
|   ↳ `favicon` | string | Favicon URL for the domain |
| `answer` | string | LLM-generated answer to the query \(if requested\) |
| `images` | array | Query-related images \(if requested\) |
|   ↳ `url` | string | Image URL |
|   ↳ `description` | string | Image description |
| `auto_parameters` | object | Automatically selected parameters based on query intent \(if enabled\) |
| `response_time` | number | Time taken for the search request in seconds |

### `tavily_extract`

Extract raw content from multiple web pages simultaneously using Tavily

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `urls` | string | Yes | URL or array of URLs to extract content from |
| `extract_depth` | string | No | The depth of extraction \(basic=1 credit/5 URLs, advanced=2 credits/5 URLs\) |
| `format` | string | No | Output format: markdown or text \(default: markdown\) |
| `include_images` | boolean | No | Incorporate images in extraction output |
| `include_favicon` | boolean | No | Add favicon URL for each result |
| `apiKey` | string | Yes | Tavily API Key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `results` | array | Successfully extracted content from URLs |
|   ↳ `url` | string | The source URL |
|   ↳ `raw_content` | string | Full extracted content from the page |
|   ↳ `images` | array | Image URLs \(when include_images is true\) |
|   ↳ `favicon` | string | Favicon URL for the result |
| `failed_results` | array | URLs that failed to extract content |
|   ↳ `url` | string | The URL that failed extraction |
|   ↳ `error` | string | Error message describing why extraction failed |
| `response_time` | number | Time taken for the extraction request in seconds |

### `tavily_crawl`

Systematically crawl and extract content from websites using Tavily

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `url` | string | Yes | The root URL to begin the crawl |
| `instructions` | string | No | Natural language directions for the crawler \(costs 2 credits per 10 pages\) |
| `max_depth` | number | No | How far from base URL to explore \(1-5, default: 1\) |
| `max_breadth` | number | No | Links followed per page level \(≥1, default: 20\) |
| `limit` | number | No | Total links processed before stopping \(≥1, default: 50\) |
| `select_paths` | string | No | Comma-separated regex patterns to include specific URL paths \(e.g., /docs/.*\) |
| `select_domains` | string | No | Comma-separated regex patterns to restrict crawling to certain domains |
| `exclude_paths` | string | No | Comma-separated regex patterns to skip specific URL paths |
| `exclude_domains` | string | No | Comma-separated regex patterns to block certain domains |
| `allow_external` | boolean | No | Include external domain links in results \(default: true\) |
| `include_images` | boolean | No | Incorporate images in crawl output |
| `extract_depth` | string | No | Extraction depth: basic \(1 credit/5 pages\) or advanced \(2 credits/5 pages\) |
| `format` | string | No | Output format: markdown or text \(default: markdown\) |
| `include_favicon` | boolean | No | Add favicon URL for each result |
| `apiKey` | string | Yes | Tavily API Key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `base_url` | string | The base URL that was crawled |
| `results` | array | Array of crawled pages with extracted content |
|   ↳ `url` | string | The crawled page URL |
|   ↳ `raw_content` | string | Full extracted page content |
|   ↳ `favicon` | string | Favicon URL for the result |
| `response_time` | number | Time taken for the crawl request in seconds |
| `request_id` | string | Unique identifier for support reference |

### `tavily_map`

Discover and visualize website structure using Tavily

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `url` | string | Yes | The root URL to begin mapping |
| `instructions` | string | No | Natural language guidance for mapping behavior \(costs 2 credits per 10 pages\) |
| `max_depth` | number | No | How far from base URL to explore \(1-5, default: 1\) |
| `max_breadth` | number | No | Links to follow per level \(default: 20\) |
| `limit` | number | No | Total links to process \(default: 50\) |
| `select_paths` | string | No | Comma-separated regex patterns for URL path filtering \(e.g., /docs/.*\) |
| `select_domains` | string | No | Comma-separated regex patterns to restrict mapping to specific domains |
| `exclude_paths` | string | No | Comma-separated regex patterns to exclude specific URL paths |
| `exclude_domains` | string | No | Comma-separated regex patterns to exclude domains |
| `allow_external` | boolean | No | Include external domain links in results \(default: true\) |
| `apiKey` | string | Yes | Tavily API Key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `base_url` | string | The base URL that was mapped |
| `results` | array | Array of discovered URLs during mapping |
|   ↳ `url` | string | Discovered URL |
| `response_time` | number | Time taken for the map request in seconds |
| `request_id` | string | Unique identifier for support reference |


