Search Google Ads locations
Searches Google’s location catalog so you can offer a location picker when you create or edit a campaign.
Pass what the person is typing as query. Results come back ordered by how well they match, and each one carries the resource_name you pass to Create campaign in geo_targets.
You do not need a connected Google Ads account, so this works before the account exists. Set country_code to keep results inside one country. An empty query returns Google’s unfiltered suggestions rather than an error.
Authorizations
Personal API key.
Path Parameters
ID of the app you are planning a Google Ads campaign for.
Query Parameters
What the person is typing. Shorter than two characters is still accepted.
Keep results inside one country, as an ISO 3166-1 alpha-2 code. Empty searches everywhere.
Most results to return.
1 <= x <= 100Response
Locations matching the search string.
Google's identifier for the location. Pass it in geo_targets when you create a campaign.
"geoTargetConstants/1014221"
The location's own name.
"San Francisco"
The location's full path, including its region and country.
"San Francisco,California,United States"
ISO 3166-1 alpha-2 country code the location sits in.
"US"
What kind of place this is, for example City, Region or Country.
"City"
Google's estimate of how many people can be reached in this location.
4200000
The query value this result was matched against, echoed back.
"san francisco"