Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Serpapi API

Give your agents access to Serpapi API. Bring your own Serpapi key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for free Get a demo

Serpapi

Instant

SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.

59 Tools

COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Serpapi without a separate account or API key for each one. New accounts start with $2 of free credit.

No Serpapi account or key

Your agent calls Serpapi through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

$0.025 per successful search, paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Serpapi with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Serpapi API to your AI assistant

Use Serpapi from the AI assistant you already work in. Connect Composio once, then paste the prompt.

1
Open the Connectors menu
Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
Add Composio to Claude
2
Add the Composio MCP server
Name it Composio, paste the MCP server URL and click Add.
https://connect.composio.dev/mcp
3
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
4
Paste the prompt
Start a new chat and paste the prompt. Claude runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
Install in ChatGPT
2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection.
3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio.
4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
Install in Cursor
2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.

1
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
Add to Grok Bot
2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.

1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
Set up Composio from composio.dev/hermes
2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.

ClaudeNew chat

Paste this prompt

Use SerpApi through Composio Instant to search Google for how solar panels generate electricity. Return the title and URL for each organic result.

What success looks like

SERPAPI_SEARCH

Your assistant runs SerpApi and replies with a list of organic search results, each with a title and URL.

Runs on Composio Instant

SDK

Use the Serpapi API in your code

Call Serpapi from your own agent with the Composio SDK. Four steps and one tool call.

1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
export COMPOSIO_API_KEY="your_composio_api_key"
2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.
The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.
pip install composio
npm install @composio/core
3
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
SERPAPI_SEARCH
4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.

agent.py

from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["serpapi"],
    instant={
        "toolkits": {"enable": ["serpapi"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "SERPAPI_SEARCH",
    arguments={
        "query": "how solar panels generate electricity",
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)

agent.ts

import { Composio } from "@composio/core";

const composio = new Composio();

const session = await composio.create("user_123", {
  toolkits: ["serpapi"],
  instant: {
    toolkits: { enable: ["serpapi"] },
    returnInstantCharge: true,
  },
});

const result = await session.execute(
  "SERPAPI_SEARCH",
  {
    "query": "how solar panels generate electricity"
  },
  { account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);

response

{
  "data": {
    "results": {
      "organic_results": [
        {
          "link": "<result URL>",
          "title": "<result title>",
          "position": "<position>"
        }
      ]
    }
  },
  "error": null,
  "successful": true,
  "instant_charge": {
    "amount": "<usd amount>",
    "currency": "USD",
    "charged_by": "<provider>"
  }
}

TOOLS

Available Serpapi API tools

44 Serpapi tools run on Instant, priced per call with no Serpapi key. Tools marked Your key need your own Serpapi account.

Action	Tool slug	What it does	Availability
Google Search	SERPAPI_SEARCH	Find up to five organic Google results for a query.	Instant$0.025 per successful search63% off
News Search	SERPAPI_NEWS_SEARCH	Find Google News articles that match a query.	Instant$0.025 per successful search63% off
Maps Search	SERPAPI_GOOGLE_MAPS_SEARCH	Search Google Maps for places and businesses.	Instant$0.025 per successful search63% off
Shopping Search	SERPAPI_SHOPPING_SEARCH	Find product listings on Google Shopping.	Instant$0.025 per successful search63% off
Trends Search	SERPAPI_TRENDS_SEARCH	Compare relative search interest for queries with Google Trends.	Instant$0.025 per successful search63% off
Bing Maps Search	SERPAPI_BING_MAPS	Search Bing Maps via SerpApi for local businesses and places, using a required query and an optional place ID.	Instant$0.025 per successful search63% off
Bing Search	SERPAPI_BING_SEARCH	Retrieve Bing Search Engine Results via SerpAPI.	Instant$0.025 per successful search63% off
DuckDuckGo Light Search	SERPAPI_DUCK_DUCK_GO_LIGHT_SEARCH	Tool to access the world's fastest DuckDuckGo Search API via SerpApi.	Instant$0.025 per successful search63% off
DuckDuckGo Maps search	SERPAPI_DUCK_DUCK_GO_MAPS	Scrapes DuckDuckGo Maps results via SerpApi.	Instant$0.025 per successful search63% off
DuckDuckGo search	SERPAPI_DUCK_DUCK_GO_SEARCH	Performs a DuckDuckGo search via SerpApi to retrieve SERP data, including organic results, ads, and structured information.	Instant$0.025 per successful search63% off
eBay Search	SERPAPI_EBAY_SEARCH	Search eBay product listings via SerpApi using keywords and optional location and marketplace settings.	Instant$0.025 per successful search63% off
Get Facebook profile information	SERPAPI_GET_FACEBOOK_PROFILE	Tool to retrieve public information from a Facebook profile or page using SerpAPI.	Instant$0.025 per successful search63% off
Get Google About This Result	SERPAPI_GET_GOOGLE_ABOUT_THIS_RESULT	Tool to get Google 'About this result' information for a website.	Instant$0.025 per successful search63% off
Get Google Hotels Autocomplete	SERPAPI_GET_GOOGLE_HOTELS_AUTOCOMPLETE_SUGGESTIONS	Tool to get autocomplete suggestions for Google Hotels destination searches.	Instant$0.025 per successful search63% off
Get Google Images Related Content	SERPAPI_GET_GOOGLE_IMAGES_RELATED_CONTENT	Get related content for a specific Google Images result.	Instant$0.025 per successful search63% off
Get Google Patent Details	SERPAPI_GET_GOOGLE_PATENT_DETAILS	Tool to retrieve detailed information about a specific patent or scholar document from Google Patents via SerpApi.	Instant$0.025 per successful search63% off
Google Forums Search	SERPAPI_GOOGLE_FORUMS_SEARCH	Tool to scrape forum results from Google's Forums Platform using SerpApi.	Instant$0.025 per successful search63% off
Google Images Light Search	SERPAPI_SEARCH_GOOGLE_IMAGES_LIGHT	Tool to scrape Google Images results using SerpApi's Google Images Light API.	Instant$0.025 per successful search63% off
Google Jobs Search	SERPAPI_GOOGLE_JOBS_SEARCH	Retrieve Google Jobs search results via SerpApi, with pagination, location and remote-job filtering.	Instant$0.025 per successful search63% off
Google Lens search	SERPAPI_GOOGLE_LENS_SEARCH	Performs reverse image search using Google Lens to find visually similar images, products, and related content.	Instant$0.025 per successful search63% off
Google Light Search	SERPAPI_GOOGLE_LIGHT_SEARCH	Retrieve Google Light Search Results via SerpApi.	Instant$0.025 per successful search63% off
Google Play Product Search	SERPAPI_GOOGLE_PLAY_PRODUCT	Tool to retrieve detailed Google Play product information using SerpApi.	Instant$0.025 per successful search63% off
Google Play Search	SERPAPI_PLAY_SEARCH	Retrieve Google Play Store search results in JSON, with query, country, language, category, chart, and pagination options.	Instant$0.025 per successful search63% off
Google Scholar Author Profile	SERPAPI_GOOGLE_SCHOLAR_AUTHOR	Scrapes full Google Scholar Author page including articles, citations, metrics, and co-authors.	Instant$0.025 per successful search63% off
Google Scholar Cite	SERPAPI_GOOGLE_SCHOLAR_CITE	Scrapes full Google Scholar Citations with multiple citation formats.	Instant$0.025 per successful search63% off
Google Videos Light Search	SERPAPI_GOOGLE_VIDEOS_LIGHT	Tool to scrape Google Videos results using SerpApi's ultra-fast Google Videos Light API.	Instant$0.025 per successful search63% off
Hotel Search	SERPAPI_HOTEL_SEARCH	Search Google Hotels via SerpApi using a query and check-in and check-out dates, or retrieve property details with a property token.	Instant$0.025 per successful search63% off
Image search	SERPAPI_IMAGE_SEARCH	Searches Google Images via SERP API for a given query, returning structured image results.	Instant$0.025 per successful search63% off
Naver Search	SERPAPI_NAVER_SEARCH	Search Naver for Korean web content, news, videos, and shopping results.	Instant$0.025 per successful search63% off
OpenTable Reviews Search	SERPAPI_OPEN_TABLE_REVIEWS	Tool to scrape OpenTable restaurant reviews using SerpApi.	Instant$0.025 per successful search63% off
Search Apple App Store	SERPAPI_SEARCH_APPLE_APP_STORE	Tool to search Apple App Store for iOS and Mac apps.	Instant$0.025 per successful search63% off
Search Baidu with Query	SERPAPI_BAIDU_SEARCH	Search Baidu (Chinese search engine) and retrieve search results.	Instant$0.025 per successful search63% off
Search finance	SERPAPI_FINANCE_SEARCH	Retrieves structured financial information (e.g., company data, stock details, market trends, news) from Google Finance via SERP API based on a query.	Instant$0.025 per successful search63% off
Search Google Events	SERPAPI_EVENT_SEARCH	Searches for events in Google Search's structured event results.	Instant$0.025 per successful search63% off
Search Google Local Services	SERPAPI_SEARCH_GOOGLE_LOCAL_SERVICES	Search Google Local Services for providers such as electricians, plumbers and HVAC technicians.	Instant$0.025 per successful search63% off
Search Google Scholar	SERPAPI_SCHOLAR_SEARCH	Searches Google Scholar via SerpApi for academic literature, papers, articles, and citations based on a query.	Instant$0.025 per successful search63% off
Search public Google ads	SERPAPI_SEARCH_PUBLIC_GOOGLE_ADS	Find public Google advertisements by advertiser or domain.	Instant$0.025 per successful search63% off
Search Yelp businesses	SERPAPI_SEARCH_YELP	Search Yelp for businesses and places using SerpApi.	Instant$0.025 per successful search63% off
Walmart Search	SERPAPI_WALMART_SEARCH	Retrieve Walmart search results by query, location, store ID, and other parameters.	Instant$0.025 per successful search63% off
Yahoo Search	SERPAPI_YAHOO_SEARCH	Retrieve Yahoo!	Instant$0.025 per successful search63% off
Yahoo Videos Search	SERPAPI_YAHOO_VIDEOS	Scrape Yahoo!	Instant$0.025 per successful search63% off
Yandex Images Search	SERPAPI_YANDEX_IMAGES_SEARCH	Tool to search Yandex Images for image results with advanced filters.	Instant$0.025 per successful search63% off
Yandex Search	SERPAPI_YANDEX_SEARCH	Retrieve Yandex Search Results.	Instant$0.025 per successful search63% off
YouTube Search	SERPAPI_YOU_TUBE_SEARCH	Retrieve YouTube Search Results.	Instant$0.025 per successful search63% off
Amazon Search	SERPAPI_AMAZON_SEARCH	Find Amazon products, prices, and ratings by keyword or category.	Your key

Instant prices are Serpapi's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Serpapi API use cases and example prompts

Copy a prompt into your agent. Each one uses Serpapi with apps you connect through Composio.

Track industry news for the team
Use SerpApi News Search to find Google News articles about changes in cloud data warehouse pricing. Add the matching results to my Data Market Watch sheet in Google Sheets, then post a short summary in Slack's #market-watch channel.
Apps used: Serpapi, Google Sheets, slack
Compare search interest by category
Use SerpApi Trends Search to compare relative search interest for customer data platforms and marketing automation software. Write the findings as a market brief in my Growth Research doc in Google Docs, then share the doc in Slack's #growth channel.
Apps used: Serpapi, Google Docs, slack
Build a shortlist of event venues
Use SerpApi Maps Search to find event venues in Austin for a company planning session. Add the matching places to my Venue Shortlist in Google Sheets, then post the list in Slack's #events channel.
Apps used: Serpapi, Google Sheets, slack
Research an account before outreach
Use SerpApi News Search to find recent Google News articles about Acme. Add relevant findings to the Acme company record in HubSpot, then draft a Gmail update for my sales team with the source links and a suggested reason to reach out.
Apps used: Serpapi, hubspot, Gmail

TROUBLESHOOTING

Serpapi API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Set ll to GPS coordinates in the format @latitude,longitude,zoom_level in SERPAPI_GOOGLE_MAPS_SEARCH.

Pass the terms as a comma-separated query to SERPAPI_TRENDS_SEARCH.

Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.

Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Serpapi account.

Check credential_source and instant_charge in the Composio execution log.

COMPOSIO INSTANT

Other tools on Instant

These tools also run on Composio Instant and use the same Composio balance.

Toolkit marketplace

Tavily

Api Key

Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.

Exa

Api Key

Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.

Peopledatalabs

Api Key

Peopledatalabs delivers B2B data enrichment and identity resolution APIs. Supercharge your apps with accurate, up-to-date business and contact data.

AccuWeather

Api Key

AccuWeather is a global weather service providing current conditions, forecasts, MinuteCast precipitation, alerts, and lightning data. Use it for fast, localized forecasts and real-time weather alerts.

Start with Serpapi.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Serpapi tool your agent needs.Free to start.

Start building

Serpapi API

What is Composio Instant?

No Serpapi account or key

Pay per call, at cost

Works in any agent

Works with your apps

Connect the Serpapi API to your AI assistant

Open the Connectors menu

Add the Composio MCP server

Authorize in your browser

Paste the prompt

Install the Composio plugin

Authorize in your browser

Turn on Composio in your chat

Paste the prompt

Install the Composio plugin

Paste the prompt

Add the Composio plugin

Authenticate

Paste the prompt

Paste the setup prompt

Authorize in your browser

Paste the prompt

Use the Serpapi API in your code

Set up Composio

Install the SDK

Run the call

Read the response

Available Serpapi API tools

Serpapi API use cases and example prompts

Track industry news for the team

Compare search interest by category

Build a shortlist of event venues

Research an account before outreach

Serpapi API troubleshooting

Maps results are outside the area you want

Trends does not compare several search terms

An action asks you to connect Serpapi

You get HTTP 402 with Metering_WalletBalanceExhausted

You're not sure which account was charged

Other tools on Instant

Tavily

Exa

Peopledatalabs

AccuWeather

Start with Serpapi.It takes 30 seconds.