Google Serper Maps

1 credits/call
ae_serper_maps

Search for local businesses, places, and geographic locations using Serper's Google Maps-style API.

MapsSearch
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.—
llstringNoLat/lng bias string, e.g. @40.7504,-73.9824,14z.—
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_maps' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "gl": "cn",
    "hl": "zh-cn",
    "ll": "@22.5431,114.0579,12z",
    "num": 20,
    "q": "Pop Mart"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "credits": 3,
  "ll": "@22.5429191,114.0578957,12z",
  "places": [
    {
      "address": "香港新界元朗元龍街形點I L11007",
      "cid": "16272768726764047087",
      "fid": "0x3403f1004a96cebd:0xe1d47cf0aedb4aef",
      "isUnclaimedListing": true,
      "title": "POP MART(YOHO MALL 店)",
      "type": "爱好收藏品商店"
    }
  ],
  "searchParameters": {
    "engine": "google",
    "gl": "cn",
    "hl": "zh-cn",
    "ll": "@22.5431,114.0579,12z",
    "num": 20,
    "type": "maps"
  }
}

This example shows part of the response. Copied content is valid JSON.