Skip to content

Supported Country Codes for Geolocation

This reference lists the country codes you can pass in the country_code parameter when you want a request to appear to originate from a specific location. Codes use the ISO 3166-1 format. The table below is the set available with premium proxies (premium_proxy=true). If you are using classic proxies, a separate list of supported countries applies.

How to use a country code

The country_code parameter takes a short two-letter code. For example, to request content as seen from Germany, you would pass de; for Japan, jp. The code must come from the list below and must be paired with premium_proxy=true for this particular list to apply.

Before you pick a code, decide which proxy type your request uses:

  • Premium proxies — use the table on this page. Set premium_proxy=true alongside country_code.
  • Classic proxies — use the separate classic-proxy country list, which has its own supported set.

A quick checklist:

  1. Confirm the target location's two-letter ISO 3166-1 code.
  2. Check that the code appears in the premium-proxy table below (or the classic list, if that is your proxy type).
  3. Pass the code in country_code and set the matching proxy flag.
  4. If the response does not reflect the expected region, verify you used the list that matches your proxy type before changing the code.

Two different reasons a request can miss the target region

A geolocation request can fail to produce region-specific content for two distinct reasons, and it helps to tell them apart:

  • Wrong list for the proxy type. The code may be valid for classic proxies but not present in the premium-proxy table, or vice versa. In that case the code itself is the problem for the proxy type you chose.
  • Right code, wrong flag. The code may be in the premium-proxy table but your request did not set premium_proxy=true, so the premium geolocation path was not used.

Checking both the code and the proxy flag separately narrows down which condition applies.

Worked example

Suppose you want search results as they appear to a user in Germany. The premium-proxy table lists Germany with the code de. You would pass country_code=de together with premium_proxy=true. If instead you needed a location that only appears on the classic-proxy list, you would switch to that list and the classic-proxy workflow rather than expecting the premium table to cover it.

Field and control map

Input or controlWhat it doesWhere the value comes from
country_codeSelects the geolocation for the requestTwo-letter ISO 3166-1 code from the premium-proxy table below, or from the classic-proxy list
premium_proxyEnables the premium-proxy pathSet to true when using the premium-proxy country list
Classic-proxy country listSeparate supported set for classic proxiesUse when your request runs through classic proxies

Premium-proxy country codes

The table below lists every country and territory available with premium proxies, with its country_code value. Codes are shown exactly as supplied. Some entries are historical or no longer existing entities (for example, Burma, Czechoslovakia, and the USSR); they remain in the list as supplied. Use the table as a lookup for the exact code string to pass.

Premium-proxy country codes
Country Namecountry_code
Afghanistanaf
Albaniaal
Algeriadz
American Samoaas
Andorraad
Angolaao
Anguillaai
Antarcticaaq
Antigua & Barbudaag
Argentinaar
Armeniaam
Arubaaw
Australiaau
Austriaat
Azerbaijanaz
Bahamabs
Bahrainbh
Bangladeshbd
Barbadosbb
Belarusby
Belgiumbe
Belizebz
Beninbj
Bermudabm
Bhutanbt
Boliviabo
Bosnia and Herzegovinaba
Botswanabw
Bouvet Islandbv
Brazilbr
British Indian Ocean Territoryio
British Virgin Islandsvg
Brunei Darussalambn
Bulgariabg
Burkina Fasobf
Burma (no longer exists)bu
Burundibi
Cambodiakh
Camerooncm
Canadaca
Cape Verdecv
Cayman Islandsky
Central African Republiccf
Chadtd
Chilecl
Chinacn
Christmas Islandcx
Cocos (Keeling) Islandscc
Colombiaco
Comoroskm
Congocg
Cook Iislandsck
Costa Ricacr
Croatiahr
Cubacu
Cypruscy
Czech Republiccz
Czechoslovakia (no longer exists)cs
Côte D'ivoire (Ivory Coast)ci
Democratic Yemen (no longer exists)yd
Denmarkdk
Djiboutidj
Dominicadm
Dominican Republicdo
East Timortp
Ecuadorec
Egypteg
El Salvadorsv
Equatorial Guineagq
Eritreaer
Estoniaee
Ethiopiaet
Falkland Islands (Malvinas)fk
Faroe Islandsfo
Fijifj
Finlandfi
Francefr
French Guianagf
French Polynesiapf
French Southern Territoriestf
Gabonga
Gambiagm
Georgiage
German Democratic Republic (no longer exists)dd
Germanyde
Ghanagh
Gibraltargi
Greecegr
Greenlandgl
Grenadagd
Guadeloupegp
Guamgu
Guatemalagt
Guineagn
Guinea-Bissaugw
Guyanagy
Haitiht
Heard & McDonald Islandshm
Hondurashn
Hong Konghk
Hungaryhu
Icelandis
Indiain
Indonesiaid
Iraqiq
Irelandie
Islamic Republic of Iranir
Israelil
Italyit
Jamaicajm
Japanjp
Jordanjo
Kazakhstankz
Kenyake
Kiribatiki
Korea, Democratic People's Republic ofkp
Korea, Republic ofkr
Kuwaitkw
Kyrgyzstankg
Lao People's Democratic Republicla
Latvialv
Lebanonlb
Lesothols
Liberialr
Libyan Arab Jamahiriyaly
Liechtensteinli
Lithuanialt
Luxembourglu
Macaumo
Madagascarmg
Malawimw
Malaysiamy
Maldivesmv
Maliml
Maltamt
Marshall Islandsmh
Martiniquemq
Mauritaniamr
Mauritiusmu
Mayotteyt
Mexicomx
Micronesiafm
Moldova, Republic ofmd
Monacomc
Mongoliamn
Monserratms
Moroccoma
Mozambiquemz
Myanmarmm
Namibiana
Naurunr
Nepalnp
Netherlands Antillesan
Netherlandsnl
Neutral Zone (no longer exists)nt
New Caledonianc
New Zealandnz
Nicaraguani
Nigerne
Nigeriang
Niuenu
Norfolk Islandnf
Northern Mariana Islandsmp
Norwayno
Omanom
Pakistanpk
Palaupw
Panamapa
Papua New Guineapg
Paraguaypy
Perupe
Philippinesph
Pitcairnpn
Polandpl
Portugalpt
Puerto Ricopr
Qatarqa
Romaniaro
Russian Federationru
Rwandarw
Réunionre
Saint Lucialc
Samoaws
San Marinosm
Sao Tome & Principest
Saudi Arabiasa
Senegalsn
Seychellessc
Sierra Leonesl
Singaporesg
Slovakiask
Sloveniasi
Solomon Islandssb
Somaliaso
South Africaza
South Georgia and the South Sandwich Islandsgs
Spaines
Sri Lankalk
St. Helenash
St. Kitts and Neviskn
St. Pierre & Miquelonpm
St. Vincent & the Grenadinesvc
Sudansd
Surinamesr
Svalbard & Jan Mayen Islandssj
Swazilandsz
Swedense
Switzerlandch
Syrian Arab Republicsy
Taiwan, Province of Chinatw
Tajikistantj
Tanzania, United Republic oftz
Thailandth
Togotg
Tokelautk
Tongato
Trinidad & Tobagott
Tunisiatn
Turkeytr
Turkmenistantm
Turks & Caicos Islandstc
Tuvalutv
Ugandaug
Ukraineua
Union of Soviet Socialist Republics (no longer exists)su
United Arab Emiratesae
United Kingdom (Great Britain)gb
United States Minor Outlying Islandsum
United States Virgin Islandsvi
United Statesus
Uruguayuy
Uzbekistanuz
Vanuatuvu
Vatican City State (Holy See)va
Venezuelave
Viet Namvn
Wallis & Futuna Islandswf
Western Saharaeh
Yemenye
Yugoslaviayu
Zairezr
Zambiazm
Zimbabwezw

Codes are shown exactly as supplied. Some entries are historical or no longer existing entities and remain in the list as supplied.

Frequently asked questions

What format does country_code use?

It uses the ISO 3166-1 two-letter format, such as de for Germany or jp for Japan.

Do these codes work with classic proxies?

This table is the premium-proxy list. Classic proxies have their own separate list of supported countries, so a code here is not automatically valid for classic proxies.

Why do some entries say 'no longer exists'?

The list includes some historical entities such as Burma and Czechoslovakia, shown exactly as supplied. They remain available as lookup entries in the table.

What if my code is in the table but the region looks wrong?

Check that premium_proxy=true is set alongside country_code. If the flag is missing, the premium-proxy geolocation path is not used even when the code is valid.