Google Serper Places
1 credits/call
ae_serper_places
Search for local businesses and places using Serper to find addresses, phone numbers, coordinates, ratings, and reviews.
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, when supported. | — |
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_places' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"gl": "ar",
"hl": "es",
"location": "Dolores, Buenos Aires, Argentina",
"num": 20,
"q": "bazar en Dolores"
}
}'Response exampleresponse.json
{
"credits": 1,
"places": [
{
"address": "Belgrano 202 300",
"category": "Tienda de regalos",
"cid": "2614172563633951",
"latitude": -36.31616,
"longitude": -57.676548,
"title": "Bazar chino"
}
],
"searchParameters": {
"engine": "google",
"gl": "ar",
"hl": "es",
"location": "Dolores, Buenos Aires, Argentina",
"num": 20,
"type": "places"
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows
Local Business Lead Generation with AI AgentsLet an AI agent run local lead gen end to end: give it a location and industry, search local businesses at scale, pull names, addresses and contact details, then dedupe into a ready-to-use lead list.Local Recommendation Agent: Places + Details in One PromptBuild a local recommendation flow with an AI agent — search places by city and category, pull details and ratings, then rank by your preferences, all from one plain-English prompt.


