Skip to main content
GET
Search Google Ads locations

Authorizations

api_key
string
header
required

Personal API key.

Path Parameters

app_id
string
required

ID of the app you are planning a Google Ads campaign for.

Query Parameters

query
string
default:""

What the person is typing. Shorter than two characters is still accepted.

country_code
string
default:""

Keep results inside one country, as an ISO 3166-1 alpha-2 code. Empty searches everywhere.

limit
integer
default:20

Most results to return.

Required range: 1 <= x <= 100

Response

Locations matching the search string.

resource_name
string
required

Google's identifier for the location. Pass it in geo_targets when you create a campaign.

Example:

"geoTargetConstants/1014221"

name
string
required

The location's own name.

Example:

"San Francisco"

canonical_name
string
required

The location's full path, including its region and country.

Example:

"San Francisco,California,United States"

country_code
string
required

ISO 3166-1 alpha-2 country code the location sits in.

Example:

"US"

target_type
string
required

What kind of place this is, for example City, Region or Country.

Example:

"City"

reach
integer
required

Google's estimate of how many people can be reached in this location.

Example:

4200000

search_term
string
required

The query value this result was matched against, echoed back.

Example:

"san francisco"