Serpapi

SerpApiTools enable an Agent to search Google and YouTube for a query.

Prerequisites

The following example requires the google-search-results library and an API key from SerpApi.

uv pip install -U google-search-results

export SERP_API_KEY=***

Example

The following agent will search Google for the query: “Whats happening in the USA” and share results.

cookbook/14_tools/serpapi_tools.py

from agno.agent import Agent
from agno.tools.serpapi import SerpApiTools

agent = Agent(tools=[SerpApiTools()])
agent.print_response("Whats happening in the USA?", markdown=True)

Toolkit Params

Parameter	Type	Default	Description
api_key	Optional[str]	None	SerpApi API key. If not provided, will use SERP_API_KEY environment variable.
enable_search_google	bool	True	Enable Google search functionality.
enable_search_youtube	bool	False	Enable YouTube search functionality.
all	bool	False	Enable all available functions in the toolkit.

Toolkit Functions

Function	Description
search_google	Search Google using the Serpapi API. Parameters include query (str) for the search query and num_results (int, default=10) for the number of results. Returns JSON formatted search results with organic results, recipes, shopping results, knowledge graph, and related questions.
search_youtube	Search YouTube using the Serpapi API. Parameters include query (str) for the search query. Returns JSON formatted search results with video results, movie results, and channel results.

Developer Resources

• View Tools