SearchApi Tool
Guide for using the SearchApi tool with PraisonAI agents.
The SearchApi tool lets an agent search the web through the SearchApi service.
Overview
The SearchApi tool is a tool that allows you to search the web using the SearchApi.
export SEARCHAPI_API_KEY="${SEARCHAPI_API_KEY:?Set SEARCHAPI_API_KEY in your shell}"from praisonaiagents import Agent, AgentTeam
from langchain_community.utilities import SearchApiAPIWrapper
data_agent = Agent(instructions="I am looking for the top google searches of 2025", tools=[SearchApiAPIWrapper])
editor_agent = Agent(instructions="Analyze the data and derive insights")
agents = AgentTeam(agents=[data_agent, editor_agent])
agents.start()How It Works
Getting Started
- Simple Usage
- Install dependencies (see Overview above)
- Set required API keys in your environment
- Run the agent example in Overview
- With Configuration
Use the same tool with an agent — see the Overview example, or pass env vars from the sections above.
Best Practices
Keep SEARCHAPI_API_KEY in the environment
Set SEARCHAPI_API_KEY in your shell or .env. SearchApiAPIWrapper reads it automatically — never hard-code the key.
Scope the query
SearchApi returns broad web results. Give the agent specific queries so it processes fewer, more relevant hits.
Handle rate limits
SearchApi returns HTTP 429 when the plan quota is exceeded. Wrap the call in try/except so the agent can fall back to another search tool.