---
id: tavily-python
version: "0.7.27"
license: unclear
license_treatment: permissive
maintenance: active
---

# tavily-python — Python wrapper for the Tavily API

License: permissive · Maintenance: active · Downloads: 7.1M/mo

## What it is and what it does

Tavily Python is a client library that wraps the Tavily web intelligence API, letting you call search, content extraction, website crawling, site mapping, and research report generation from Python without writing HTTP requests directly. It handles authentication, response parsing, and error handling for you, and includes a keyless mode for trying search and extract without signing up.

The SDK is designed for integration into applications that need to gather web data programmatically—feeding context into RAG systems, answering questions with current web information, extracting structured content from multiple URLs, or building research workflows. It depends on requests, tiktoken, and httpx for HTTP transport and token counting, and requires Python 3.8 or later.

Use it for:

- Feed live web search results as context into a RAG or LLM application to ground answers in current information.
- Extract raw text and images from a batch of URLs for content analysis or data collection pipelines.
- Crawl a website with natural-language instructions to gather pages matching specific criteria.
- Generate structured research reports on a topic with automatic source gathering and citation formatting.
- Build a Q&A system that retrieves and synthesizes answers from the web in a single API call.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python SDK for the Tavily API, providing web search, content extraction, website crawling, site mapping, and research report generation directly from Python code.

Yes. The package is actively maintained, has low install friction, carries no security vulnerabilities, and uses a permissive MIT license. It is well-suited for developers building web-aware applications, RAG systems, or research automation. The keyless mode lets you try it immediately; an API key unlocks the full feature set. Install if you need programmatic web search, extraction, or research capabilities.

## Install

pip install tavily-python
uv add tavily-python
poetry add tavily-python

## Installing tavily-python

Before you install: Low friction installation with a pure-Python wheel. Active maintenance with recent commits and steady releases. Depends on requests, tiktoken, and httpx—all stable, widely-used libraries with no known friction.

License in practice: MIT license (permissive). No restrictions on commercial or proprietary use; you may modify and distribute freely as long as you include the license notice.

Quickstart:

pip install tavily-python

from tavily import TavilyClient

client = TavilyClient(api_key="tvly-YOUR_API_KEY")
response = client.search("Who is Leo Messi?")
print(response)

Requires a Tavily API key for most endpoints (search, extract, crawl, map, research); keyless mode available for search() and extract() only with rate limits.

Verify before relying:

- Whether the keyless mode rate limits are sufficient for typical development workflows.
- Performance characteristics and latency for large-scale crawl or research operations.
- Cost structure and pricing tiers for API key holders.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 7.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

web search api python, content extraction sdk, website crawler python, rag context generation, tavily api wrapper, web research automation, python search integration, web-search, rag-integration, api-client

[View on SkillFed](https://skillfed.io/packages/tavily-python) · [View on PyPI](https://pypi.org/project/tavily-python/)