[Feat] Add Tavily Search API

[ishaan-jaff]

[Feat] Add Tavily Search API

Provides a unified interface for search, use Tavily API here

Adds https://docs.tavily.com/documentation/api-reference/endpoint/search

Relevant issue

#15314

Add Tavily Search Provider to Unified Search API

Summary

This PR adds Tavily Search API support to LiteLLM's unified search interface, enabling users to perform web searches using Tavily alongside the existing Perplexity provider. Tavily provides AI-powered search optimized for LLM applications with features like automatic parameter tuning and rich search results.

Usage

Basic Search

import litellm

# Simple Tavily search
response = litellm.search(
    query="Who is Leo Messi?",
    custom_llm_provider="tavily"
)

for result in response.results:
    print(f"{result.title}: {result.url}")
    print(f"{result.snippet}\n")

With Options

import litellm

# Search with domain filtering and max results
response = litellm.search(
    query="latest AI developments",
    custom_llm_provider="tavily",
    max_results=10,
    search_domain_filter=["techcrunch.com", "theverge.com", "wired.com"],
    country="United States"
)

Async Search

import litellm

response = await litellm.asearch(
    query="machine learning research",
    custom_llm_provider="tavily",
    max_results=5
)

Environment Setup

export TAVILY_API_KEY="tvly-your-api-key-here"

# Optional: Override API base
export TAVILY_API_BASE="https://api.tavily.com"

Relevant issues

Pre-Submission checklist

Please complete all items before asking a LiteLLM maintainer to review your PR

• I have Added testing in the tests/litellm/ directory, Adding at least 1 test is a hard requirement - see details
• I have added a screenshot of my new test passing locally
• My PR passes all unit tests on make test-unit
• My PR's scope is as isolated as possible, it only solves 1 specific problem

Type

🆕 New Feature
✅ Test

Changes

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
litellm	Ready	Preview	Comment	Oct 22, 2025 0:03am