If you plan to use the Google Ads API via Python or another client, you will have to mention the location id(s) in your request.
You can download the latest CSV version of the file listing location IDs via this link.
If you’re looking to call the API for country-level requests, I have compiled a shortlist of the codes corresponding to 216 countries.
For instance, the code/id for the USA is 2840, for the UK 2826, for France 2250 and for Germany 2276.
Criteria ID Name
2004 Afghanistan
2008 Albania
2010 Antarctica
2012 Algeria
2016 American Samoa
2020 Andorra
2024 Angola
2028 Antigua and Barbuda
2031 Azerbaijan
2032 Argentina
2036 Australia
2040 Austria
2044 The Bahamas
2048 Bahrain
2050 Bangladesh
2051 Armenia
2052 Barbados
2056 Belgium
2064 Bhutan
2068 Bolivia
2070 Bosnia and Herzegovina
2072 Botswana
2076 Brazil
2084 Belize
2090 Solomon Islands
2096 Brunei
2100 Bulgaria
2104 Myanmar (Burma)
2108 Burundi
2112 Belarus
2116 Cambodia
2120 Cameroon
2124 Canada
2132 Cape Verde
2140 Central African Republic
2144 Sri Lanka
2148 Chad
2152 Chile
2156 China
2162 Christmas Island
2166 Cocos (Keeling) Islands
2170 Colombia
2174 Comoros
2178 Republic of the Congo
2180 Democratic Republic of the Congo
2184 Cook Islands
2188 Costa Rica
2191 Croatia
2196 Cyprus
2203 Czechia
2204 Benin
2208 Denmark
2212 Dominica
2214 Dominican Republic
2218 Ecuador
2222 El Salvador
2226 Equatorial Guinea
2231 Ethiopia
2232 Eritrea
2233 Estonia
2239 South Georgia and the South Sandwich Islands
2242 Fiji
2246 Finland
2250 France
2258 French Polynesia
2260 French Southern and Antarctic Lands
2262 Djibouti
2266 Gabon
2268 Georgia
2270 The Gambia
2276 Germany
2288 Ghana
2296 Kiribati
2300 Greece
2308 Grenada
2316 Guam
2320 Guatemala
2324 Guinea
2328 Guyana
2332 Haiti
2334 Heard Island and McDonald Islands
2336 Vatican City
2340 Honduras
2348 Hungary
2352 Iceland
2356 India
2360 Indonesia
2368 Iraq
2372 Ireland
2376 Israel
2380 Italy
2384 Cote d'Ivoire
2388 Jamaica
2392 Japan
2398 Kazakhstan
2400 Jordan
2404 Kenya
2410 South Korea
2414 Kuwait
2417 Kyrgyzstan
2418 Laos
2422 Lebanon
2426 Lesotho
2428 Latvia
2430 Liberia
2434 Libya
2438 Liechtenstein
2440 Lithuania
2442 Luxembourg
2450 Madagascar
2454 Malawi
2458 Malaysia
2462 Maldives
2466 Mali
2470 Malta
2478 Mauritania
2480 Mauritius
2484 Mexico
2492 Monaco
2496 Mongolia
2498 Moldova
2499 Montenegro
2504 Morocco
2508 Mozambique
2512 Oman
2516 Namibia
2520 Nauru
2524 Nepal
2528 Netherlands
2531 Curacao
2534 Sint Maarten
2535 Caribbean Netherlands
2540 New Caledonia
2548 Vanuatu
2554 New Zealand
2558 Nicaragua
2562 Niger
2566 Nigeria
2570 Niue
2574 Norfolk Island
2578 Norway
2580 Northern Mariana Islands
2581 United States Minor Outlying Islands
2583 Federated States of Micronesia
2584 Marshall Islands
2585 Palau
2586 Pakistan
2591 Panama
2598 Papua New Guinea
2600 Paraguay
2604 Peru
2608 Philippines
2612 Pitcairn Islands
2616 Poland
2620 Portugal
2624 Guinea-Bissau
2626 Timor-Leste
2634 Qatar
2642 Romania
2643 Russia
2646 Rwanda
2652 Saint Barthelemy
2654 Saint Helena, Ascension and Tristan da Cunha
2659 Saint Kitts and Nevis
2662 Saint Lucia
2663 Saint Martin
2666 Saint Pierre and Miquelon
2670 Saint Vincent and the Grenadines
2674 San Marino
2678 Sao Tome and Principe
2682 Saudi Arabia
2686 Senegal
2688 Serbia
2690 Seychelles
2694 Sierra Leone
2702 Singapore
2703 Slovakia
2704 Vietnam
2705 Slovenia
2706 Somalia
2710 South Africa
2716 Zimbabwe
2724 Spain
2736 Sudan
2740 Suriname
2748 Eswatini
2752 Sweden
2756 Switzerland
2762 Tajikistan
2764 Thailand
2768 Togo
2772 Tokelau
2776 Tonga
2780 Trinidad and Tobago
2784 United Arab Emirates
2788 Tunisia
2792 Turkey
2795 Turkmenistan
2798 Tuvalu
2800 Uganda
2804 Ukraine
2807 North Macedonia
2818 Egypt
2826 United Kingdom
2831 Guernsey
2832 Jersey
2834 Tanzania
2840 United States
2854 Burkina Faso
2858 Uruguay
2860 Uzbekistan
2862 Venezuela
2876 Wallis and Futuna
2882 Samoa
2887 Yemen
2894 Zambia
You will also need the language_id to call the API (it defaults to 1000 for English).
The CSV for all languages is available here.
The code for French is 1002, for German 1001, for Spanish 1003 and for Italian 1004.
👉 Bear in mind that the codes / ids for locations have to be declared as a list (even if consisting of a single country).
So you’ll have to write [“2840”] for the US.
Subscribe to my weekly newsletter packed with tips & tricks around AI, SEO, coding and smart automations
