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.

Search
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
qstringYesSearch query. The request body field name must be q (not query).—
glstringNoCountry code / geographic market, e.g. us.—
hlstringNoLanguage code, e.g. en.—
numintegerNoNumber of results requested.—
tbsstringNoGoogle time/search filter string, e.g. qdr:w.—
pageintegerNoPage number, when supported.—
locationstringNoHuman-readable location bias, when supported.—
autocorrectbooleanNoWhether query autocorrect should be enabled.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request 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
JSONPartial content
{
  "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.