Google Serper Maps
1 credits/call
ae_serper_maps
Search for local businesses, places, and geographic locations using Serper's Google Maps-style API.
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. | — |
ll | string | No | Lat/lng bias string, e.g. @40.7504,-73.9824,14z. | — |
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_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
{
"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.


