Give Python AI agents live web, news, maps, image, shopping, video, hotel, and flight search with easy-to-use, customizable tools.
Read the full documentation for guides, SDK examples, recipes, and the API reference.
The package creates native SerpApi tools for popular Python agent SDKs:
from serpapi_search_tools import maps_search, news_search, web_search
tools = [
web_search(),
news_search(),
maps_search(),
]When one supported agent SDK is installed, the package detects it and creates tools ready for that SDK.
If your agent SDK is already installed, add only the base package:
pip install serpapi-search-toolsIf you want this package to install a compatible agent SDK too, choose its extra. For example:
pip install "serpapi-search-tools[openai-agents]"Extras are available for all supported SDKs listed below.
Set a SerpApi key:
export SERPAPI_API_KEY="your-key"SERPAPI_KEY is also supported. A directly supplied api_key= takes precedence over environment variables.
| SDK | Install extra | Returned tool |
|---|---|---|
| OpenAI Agents SDK | openai-agents |
OpenAI Agents FunctionTool |
| Pydantic AI | pydantic-ai |
Pydantic AI Tool |
| LangChain | langchain |
LangChain StructuredTool |
| LangGraph | langgraph |
LangChain-compatible structured tool |
| CrewAI | crewai |
CrewAI BaseTool |
| LlamaIndex | llamaindex |
LlamaIndex FunctionTool |
| Claude Agent SDK | claude-agent-sdk |
Claude SDK MCP tool |
| Microsoft Agent Framework | microsoft-agent-framework |
Microsoft Agent Framework FunctionTool |
| AutoGen | autogen |
AutoGen FunctionTool |
| Haystack | haystack |
Haystack Tool |
| Semantic Kernel | semantic-kernel |
Semantic Kernel function |
| Agno | agno |
Agno Function |
| smolagents | smolagents |
smolagents Tool |
| Google ADK | google-adk |
Google ADK FunctionTool |
This quickstart uses OpenAI Agents SDK to demonstrate automatic detection. It assumes the SDK is already installed in your environment (install it with pip install openai-agents if needed). Then add the base package:
pip install serpapi-search-toolsWith one supported SDK installed, create the tool without any configuration. The package detects OpenAI Agents SDK and returns its native FunctionTool. This example also expects the OPENAI_API_KEY used by your agent.
from agents import Agent, Runner
from serpapi_search_tools import web_search
agent = Agent(
name="research-agent",
instructions="Use web search when the answer needs current information.",
tools=[web_search()],
)
result = Runner.run_sync(
agent,
"Find three recent Python packaging changes and explain why they matter.",
)
print(result.final_output)Install the LangChain extra and the model backend used by this example:
pip install "serpapi-search-tools[langchain]" langchain-openaiThe langchain extra installs a compatible LangChain version. langchain-openai provides this example's model integration; replace it with the backend your LangChain application uses. With langchain-openai, set OPENAI_API_KEY before running the agent.
from langchain.agents import create_agent
from langchain_openai import ChatOpenAI
from serpapi_search_tools import maps_search, news_search, web_search
agent = create_agent(
model=ChatOpenAI(model="gpt-5.4-mini", temperature=0),
tools=[
web_search(),
news_search(),
maps_search(),
],
)
result = agent.invoke(
{
"messages": [
{
"role": "user",
"content": (
"Research coffee culture in Austin using current reporting, "
"local places, and general web sources."
),
}
]
}
)
print(result["messages"][-1].content)The constructors use automatic SDK detection, just as in the first quickstart. For multi-SDK environments and explicit selection, see Agent SDKs.
For a step-by-step explanation, keys, customization, and troubleshooting, read the detailed quickstart.
Browse the runnable examples for focused integrations or the agent cookbook for complete, task-oriented agents built with every supported SDK.
| Constructor | SerpApi engine(s) | Required search inputs |
|---|---|---|
web_search |
google, google_light, bing, yahoo, duckduckgo |
query |
news_search |
google_news |
query |
maps_search |
google_maps |
query |
images_search |
google_images |
query |
shopping_search |
google_shopping, amazon, walmart, ebay |
query |
videos_search |
youtube |
query |
hotels_search |
google_hotels |
query, check_in_date, check_out_date |
flights_search |
google_flights |
departure_id, arrival_id, outbound_date |
travel_explore_search |
google_travel_explore |
departure_id |
from serpapi_search_tools import WebSearchEngine, web_search
tool = web_search(
allowed_engines=[WebSearchEngine.GOOGLE_LIGHT, WebSearchEngine.BING],
default_engine=WebSearchEngine.GOOGLE_LIGHT,
)SerpApi supports multiple general web search engines, including Google Light, Google, Bing, Yahoo, and DuckDuckGo. Google Light is the default because it provides fast, general-purpose web results. Use allowed_engines to choose which engines are available and default_engine to select the initial one.
from serpapi_search_tools import images_search, maps_search, news_search, videos_search
tools = [
news_search(),
maps_search(),
images_search(),
videos_search(),
]news_search supports keyword searches in Google News. maps_search searches Google Maps and accepts optional location, zoom (3 through 30), and nearby fields. Use nearby=True for “near me” intent with a separate location; leave it false when the query already names a city or area. Place details, reviews, and directions use different SerpApi APIs and are not part of this search tool.
images_search returns images and their source pages. videos_search searches YouTube videos, Shorts, channels, playlists, movies, and categories.
from serpapi_search_tools import ShoppingSearchEngine, shopping_search
tool = shopping_search(
allowed_engines=[
ShoppingSearchEngine.GOOGLE_SHOPPING,
ShoppingSearchEngine.AMAZON,
ShoppingSearchEngine.WALMART,
ShoppingSearchEngine.EBAY,
],
)Use the same query input for every marketplace. The package translates it to the selected engine's request format.
from serpapi_search_tools import flights_search, hotels_search, travel_explore_search
travel_tools = [
hotels_search(),
flights_search(),
travel_explore_search(),
]These constructors create hotel, flight, and destination-discovery tools for the detected agent SDK. Read the Hotels, Flights, and Travel Explore guides for their date, occupancy, location ID, and trip rules.
Every constructor accepts:
| Option | Purpose |
|---|---|
provider |
Defaults to "auto"; select an SDK explicitly only when multiple supported SDKs share an environment |
include_examples |
Include or omit a short example in the model description |
api_key |
Explicit SerpApi key |
client |
Custom object with search(params) for caching, interception, or tests |
default_params |
Application-controlled SerpApi options |
timeout |
Timeout passed to the SerpApi SDK client |
name |
Tool name presented to the model |
mode |
Result detail level; compact mode is the default, while full mode keeps supporting sections and all fields on retained results |
result_limit |
Maximum items kept in each result list in either mode; defaults vary by tool; use None for all results |
web_search and shopping_search also accept allowed_engines and default_engine. The tool offers only the engine values you configure.
Use default_params for documented SerpApi settings that should stay under your application's control, such as locale, currency, safe search, or pagination. Use result_limit to control how many results the tool returns. The agent continues to supply only the inputs described by its search tool.
tool = news_search(
default_params={"hl": "en", "gl": "us"},
)Typed tool inputs override matching values in default_params, and the constructor always controls engine. The package rejects known incompatible combinations, such as a Google News query with a topic token, an Amazon keyword search with node, or flight airline include and exclude filters. A multi-engine tool sends the same defaults to every allowed engine, so use parameters shared by those engines or create separate tool instances. Reserved keys (api_key, async, engine, and output) are rejected in default_params; use the constructor options above instead.
Read Manage LLM context for compact and full response behavior, default result limits, and unlimited responses.
The search runtime raises SerpApiSearchError for SerpApi and transport failures. Invalid tool inputs raise ValueError. Agent SDKs surface or handle tool errors differently, so use your SDK's normal tool-error mechanism. See Debugging for detailed examples.
Show supported SerpApi engines
For AI coding agents that need broader SerpApi API context, use SerpApi's agent-friendly documentation index (llms.txt). It links directly to Markdown API references, including APIs beyond those wrapped by this package.