Skip to main content
GET
List of Google Locations for SERP API
Returns the full list of locations supported by the Google SERP API, so you can resolve the location_code used when posting SERP tasks. Each entry carries location_code, location_name, location_code_parent, country_iso_code and location_type. 💰 Upstream is free — DataForSEO does not charge for this dictionary; AIsa bills the flat $0.012 family rate. Wrapped in DataForSEO’s envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

Example

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. The commands per client, and what each call costs, are on aisa.one/mcp.
Set this endpoint up in your agent →

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Successful response

version
string

The current version of the API

status_code
integer

General status code

status_message
string

General informational message

time
string

Execution time, seconds

cost
number

Total tasks cost, USD (0 for these free dictionary endpoints)

tasks_count
integer

The number of tasks in the tasks array

tasks_error
integer

The number of tasks in the tasks array returned with an error

tasks
string[]

Array of tasks

tasks[].result
string[]

Array of available locations

tasks[].result[].location_code
integer

Location code — pass this as location_code when posting a SERP task

tasks[].result[].location_name
string

Full location name

tasks[].result[].location_code_parent
integer

Parent location code (e.g. the country a city belongs to)

tasks[].result[].country_iso_code
string

Country ISO code

tasks[].result[].location_type
string

Location type (Country, Region, City, etc.)