Tavily
Tavily Python SDK is a wrapper for the Tavily API, providing search, extract, crawl, map, and research functionalities. It solves the problem of integrating web search and content extraction into Python applications. It is for developers building AI applications, RAG systems, or tools that need web data.
✨ Key features
- Search the web with simple queries or exact match.
- Extract raw content from up to 20 URLs at once.
- Crawl websites with depth and limit controls.
- Map website structure with instructions.
- Generate research reports with sources and citations.
- Support for keyless mode and custom HTTP sessions.
🎯 Use cases
- Build a RAG application by generating context strings from search results.
- Extract content from multiple URLs for data collection.
- Crawl a website to find pages matching specific criteria.
- Create comprehensive research reports on any topic.
- Integrate web search into LLM-based applications.
📦 Installation
🧰 Requirements: Python 3.x, an API key for full features (optional for keyless mode), and internet access.
pip install tavily-python
🚀 Usage
from tavily import TavilyClient
# Step 1. Instantiating your TavilyClient
tavily_client = TavilyClient(api_key="tvly-YOUR_API_KEY")
# Step 2. Executing a simple search query
response = tavily_client.search("Who is Leo Messi?")
# Step 3. That's it! You've done a Tavily Search!
print(response)
⚠️ Good to know
Crawl is invite-only; keyless mode is rate-limited and supports only search and extract.
❓ FAQ
Can I use Tavily without an API key?
Yes, you can instantiate TavilyClient() with no arguments to use keyless mode, which supports search and extract only.
How do I get a quick answer to a question?
Use the qna_search method, which returns a concise answer to your query.
Can I use a custom HTTP session for API gateway integration?
Yes, you can pass a pre-configured requests.Session or httpx.AsyncClient to TavilyClient or AsyncTavilyClient, and the API key becomes optional.
What is the cost of using Tavily?
Tavily is free for personal use up to 1,000 credits per month; additional usage requires paid credits.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.