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.

Maps
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, when supported.—
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_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
JSONPartial content
{
  "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