Geo targets

  • Geo targets can be retrieved directly from the Google Ads API by querying thegeo_target_constant field.

  • A zipped CSV of geo targets is available for download with different versions listed.

  • The CSV includes columns for Criteria ID, Name, Canonical Name, Parent ID, Country Code, Target Type, and Status.

  • Some countries or territories are not targetable in Google Ads but may appear in reports.

  • For DMA data, contact The Nielsen Company directly.

To retrieve geo targets directly from the Google Ads API, query thegeo_target_constant field.

Download CSV of geo targets

Latest zipped CSV (2025-10-29)

Previous zipped CSV (2025-07-15)

Columns

Criteria ID
Unique and persistent assigned ID.
Name
Best available English name of the geo target.
Canonical Name
The constructed fully qualified English name consisting of the target's ownname, and that of its parent and country. This field is meant only fordisambiguating similar target names.
Parent ID
The criteria ID of a parent. This field is included only for legacy support,so IDs might not be consistent across datasets.
Country Code
The ISO-3166-1 alpha-2 country code that is associated with the target.
Target Type

Allowable values:

  • Airport
  • Autonomous Community
  • Barrio
  • Borough
  • Canton
  • City
  • City Region
  • Colloquial Area
  • Commune
  • Congressional District
  • Country
  • County
  • Department
  • District
  • Division
  • Governorate
  • Municipality
  • Municipality District
  • National Park
  • Neighborhood
  • Okrug
  • Postal Code
  • Prefecture
  • Province
  • Quarter
  • Region
  • State
  • Sub District
  • Sub Ward
  • Territory
  • TV Region
  • Union Territory
  • University
Status

Allowable values:

  • Active: Location is valid.
  • Removal Planned: Location is obsolete and will be removed in the nextversion.

The allowed values in the CSV file differ from the enum values forgeo_target_constant.status, which areENABLED (equivalent toActive),REMOVAL_PLANNED,UNKNOWN, andUNSPECIFIED. When using the Google Ads API,you cannot query forUNKNOWN values ofgeo_target_constant.status.

Non-targetable locations

Some countries or territories are not targetable in Google Ads but might appearin reports based on the user's location of interest or physical location.

Check the list of restricted countries

Due to advertising regulations and laws of the People's Republic of China, youmay be asked to provide certificates and licenses if you are advertising certaincategories of products in China. You don't need to submit certificates untilafter your account has been activated. Once your account is active, you will beprovided with information on how to submit certificates to Google.

DMA regions

ContactThe NielsenCompanydirectly for DMA data.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-03 UTC.