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

Serper API

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

Get started for free Get a demo

Serper

Instant

Serper is a search API that returns Google search results, place data, autocomplete, and webpage extraction. It provides structured, up-to-date web and place information for programmatic use.

15 Tools

COMPOSIO INSTANT

What is Composio Instant?

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

No Serper account or key

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

Pay per call, at cost

$0.001 per credit used for web searches, 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 Serper with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Serper API to your AI assistant

Use Serper 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 Serper through Composio Instant to search Google web results for how solar panels work. Return three organic results with each title and URL.

What success looks like

SERPER_SEARCH_WEB

Your assistant runs Serper and replies with three organic search results, each with a title and URL.

Runs on Composio Instant

SDK

Use the Serper API in your code

Call Serper 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.
SERPER_SEARCH_WEB
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=["serper"],
    instant={
        "toolkits": {"enable": ["serper"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "SERPER_SEARCH_WEB",
    arguments={
        "query": "how solar panels work",
        "result_count": 3,
    },
    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: ["serper"],
  instant: {
    toolkits: { enable: ["serper"] },
    returnInstantCharge: true,
  },
});

const result = await session.execute(
  "SERPER_SEARCH_WEB",
  {
    "query": "how solar panels work",
    "result_count": 3
  },
  { account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);

response

{
  "data": [
    "<search result with title and URL>"
  ],
  "successful": true,
  "instant_charge": {
    "amount": "<usd amount>",
    "currency": "USD",
    "charged_by": "<provider>"
  }
}

TOOLS

Available Serper API tools

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

Action	Tool slug	What it does	Availability
Search the Web	SERPER_SEARCH_WEB	Find web pages and available answers, questions, and related searches.	Instant$0.001 per credit used for web searches70% off
Batch Search	SERPER_BATCH_SEARCH_WEB	Run up to 10 independent Google web searches in one request.	Instant$0.001 per credit (1 credit/query for 1-10 results; 2 credits/query for 11-100; 1-10 queries/batch)70% off
Scrape Webpage	SERPER_SCRAPE_WEBPAGE	Extract text and metadata from a webpage.	Instant$0.001 per scrape credit (2, 6, or 10 per page)70% off
Search News	SERPER_SEARCH_NEWS	Find recent news articles with links, sources, and publication times.	InstantFrom $0.001 per news search.70% off
Search Maps	SERPER_SEARCH_MAPS	Find places on Google Maps and get their identifiers and contact details.	Instant$0.001 per map-search credits (3 per page)70% off
Search Shopping	SERPER_SEARCH_SHOPPING	Find products with prices, merchants, offers, and ratings.	Instant$0.001 per shopping-search credits (2 per page)70% off
Search Images	SERPER_SEARCH_IMAGES	Find images with source pages, image URLs, and dimensions.	Instant$0.001 per image-search credits (100 results use 2 credits)70% off
Get Search Suggestions	SERPER_GET_SEARCH_SUGGESTIONS	Return Google autocomplete suggestions for a partial search query without running a full search.	InstantFrom $0.001 per request.70% off
List Place Reviews	SERPER_LIST_PLACE_REVIEWS	Return paginated Google reviews for one place identified by Place ID, feature ID, or CID, with optional sorting and topic filtering.	InstantFrom $0.001 per page of reviews.70% off
Search Scholar	SERPER_SEARCH_SCHOLAR	Search Google Scholar and return one page of academic publications with citation counts, publication metadata, snippets, and PDF links when available.	InstantFrom $0.001 per scholar search.70% off
Search Videos	SERPER_SEARCH_VIDEOS	Find videos with source links, durations, channels, and dates.	Your key

Instant prices are Serper'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

Serper API use cases and example prompts

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

Compare headset prices for support
Use Serper to find online listings for noise-canceling headsets for Acme's support team. Add each product's price, merchant, and rating to my Headset Price Tracker in Google Sheets. Post the main price differences in Slack's #procurement channel.
Apps used: Serper, Google Sheets, Slack
Document webhook retry behavior
Use Serper to find and scrape documentation about webhook delivery retries. Write a support guide with the source URLs and steps for diagnosing repeated deliveries as a page in my Support Playbook in Notion.
Apps used: Serper, Notion
Source venues for customer workshops
Use Serper to find customer workshop venues in the cities listed in my Workshop Locations sheet in Google Sheets. Add venue names, addresses, and business contact details to my Workshop Venues sheet. Draft a Gmail inquiry to each venue's general booking contact asking about room availability and rates.
Apps used: Serper, Google Sheets, Gmail
Plan content from search questions
Use Serper to find search questions and related searches about Acme's API monitoring product category. Add the phrases, source URLs, and suggested content topics to my SEO Content Plan in Google Sheets. Post the three strongest topic ideas in Slack's #content-planning channel.
Apps used: Serper, Google Sheets, Slack

TROUBLESHOOTING

Serper API troubleshooting

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

Set exactly one of query, place_id, or cid in SERPER_SEARCH_MAPS. Use cursor to continue a prior search.

Set include_links to true in SERPER_SCRAPE_WEBPAGE.

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 Serper 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

Browser Use

Api Key

Browser Use Cloud provides hosted browser agents, managed browser sessions, workspaces, profiles, and integrations. Use it to run browser-based automations at scale with managed sessions and profiles.

Firecrawl

Api Key

Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.

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.

Start with Serper.It takes 30 seconds.

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

Start building

Serper API

What is Composio Instant?

No Serper account or key

Pay per call, at cost

Works in any agent

Works with your apps

Connect the Serper 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 Serper API in your code

Set up Composio

Install the SDK

Run the call

Read the response

Available Serper API tools

Serper API use cases and example prompts

Compare headset prices for support

Document webhook retry behavior

Source venues for customer workshops

Plan content from search questions

Serper API troubleshooting

Maps search rejects a first-page request

Scraped page omits its links

An action asks you to connect Serper

You get HTTP 402 with Metering_WalletBalanceExhausted

You're not sure which account was charged

Other tools on Instant

Browser Use

Firecrawl

Tavily

Exa

Start with Serper.It takes 30 seconds.