DataForSEO Google Ads Locations By Country

1 credits/call
ae_dataforseo_google_ads_locations_by_country

Find available geographic locations for Google Ads keyword data using DataForSEO.

Maps
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
countrystringYesRequired two-letter ISO country code, e.g. us or cn. Case-insensitive; global directory requests are not accepted.—

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_dataforseo_google_ads_locations_by_country' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "country": "SG"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "cost": 0,
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "cost": 0,
      "data": {
        "api": "keywords_data",
        "function": "locations",
        "se": "google_ads"
      },
      "id": "11151309-2802-0120-0000-f82ccc219810",
      "path": [
        "v3"
      ],
      "result": [
        {
          "country_iso_code": "SG",
          "location_code": 2702,
          "location_name": "Singapore",
          "location_type": "Country"
        }
      ],
      "result_count": 60
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0
}

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