tavily-python

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 on this page — 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

tavily-python on PyPI

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

Evidence: tavily_python-0.7.27-py3-none-any.whl

Tags

More WWW/HTTP packages