Google Serper Search
1 credits/call
ae_serper_search
Search the web for real-time results, including news, images, videos, local places, and academic papers.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
q | string | Yes | Search query. The request body field name must be q (not query). | — |
gl | string | No | Country code / geographic market, e.g. us. | — |
hl | string | No | Language code, e.g. en. | — |
num | integer | No | Number of results requested. | — |
tbs | string | No | Google time/search filter string, e.g. qdr:w. | — |
page | integer | No | Page number, when supported. | — |
location | string | No | Human-readable location bias, when supported. | — |
autocorrect | boolean | No | Whether query autocorrect should be enabled. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_serper_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"gl": "us",
"hl": "en",
"num": 10,
"q": "how to calculate fabric consumption"
}
}'Response exampleresponse.json
{
"credits": 1,
"organic": [
{
"displayedLink": "https://www.scribd.com › Consumption-and-Chart",
"link": "https://www.scribd.com/document/267922387/Consumption-and-Chart",
"position": 1,
"snippet": "The key factors that affect fabric consumption calculations are the measurements and specifications of each garment part, the GSM and quality of the fabric, the ...",
"title": "Fabric Consumption Calculation Guide | PDF"
}
],
"peopleAlsoAsk": [
{
"question": "What is the formula for calculating fabric consumption?"
}
],
"relatedSearches": [
{
"query": "How to calculate fabric consumption for garments"
}
],
"searchParameters": {
"engine": "google",
"gl": "us",
"hl": "en",
"num": 10,
"q": "how to calculate fabric consumption",
"type": "search"
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows
What Is MCP? A Practical Guide to Model Context Protocol for AI AgentsMCP (Model Context Protocol) lets AI agents call external tools and data through a standard interface. Learn what MCP is, how it works, and how to connect {{TOOL_COUNT}} tools to Claude Code, Cursor and more.How to Connect AgentEarth to Cursor (MCP Setup, Step by Step)A hands-on guide to connecting AgentEarth to Cursor over MCP. Add the server, paste one config, verify the connection, and call {{TOOL_COUNT}} tools from natural language inside Cursor.What Is a Remote MCP Server and How to Connect ItA remote MCP server runs your tools in the cloud so agents connect over HTTP with no local setup. Learn how remote MCP differs from local, why it scales better, and how to connect it to Claude Code, Cursor and VSCode.Google SERP Rank Tracking with AI AgentsLet an AI agent pull live Google organic results by keyword and location, review a domain's overall ranking profile, and compare day-over-day changes into an automated rank report — no more checking rankings by hand.Mining Google \"People Also Ask\" with AI AgentsLet an AI agent collect Google \"People Also Ask\" questions in bulk, merge near-duplicate phrasings, and turn them into FAQs and content topics that hit real search demand — instead of guessing.Real-Time Web Search for AI Agents: Picking the Right EngineGive your AI agent real-time web search. Reach Serper, Tavily, Brave, Exa and Linkup from one platform, switch by freshness, semantics or source quality, and get sourced answers from a single prompt.



