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:
- Confirm the target location's two-letter ISO 3166-1 code.
- Check that the code appears in the premium-proxy table below (or the classic list, if that is your proxy type).
- Pass the code in country_code and set the matching proxy flag.
- 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 control | What it does | Where the value comes from |
|---|---|---|
| country_code | Selects the geolocation for the request | Two-letter ISO 3166-1 code from the premium-proxy table below, or from the classic-proxy list |
| premium_proxy | Enables the premium-proxy path | Set to true when using the premium-proxy country list |
| Classic-proxy country list | Separate supported set for classic proxies | Use 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.
| Country Name | country_code |
|---|---|
| Afghanistan | af |
| Albania | al |
| Algeria | dz |
| American Samoa | as |
| Andorra | ad |
| Angola | ao |
| Anguilla | ai |
| Antarctica | aq |
| Antigua & Barbuda | ag |
| Argentina | ar |
| Armenia | am |
| Aruba | aw |
| Australia | au |
| Austria | at |
| Azerbaijan | az |
| Bahama | bs |
| Bahrain | bh |
| Bangladesh | bd |
| Barbados | bb |
| Belarus | by |
| Belgium | be |
| Belize | bz |
| Benin | bj |
| Bermuda | bm |
| Bhutan | bt |
| Bolivia | bo |
| Bosnia and Herzegovina | ba |
| Botswana | bw |
| Bouvet Island | bv |
| Brazil | br |
| British Indian Ocean Territory | io |
| British Virgin Islands | vg |
| Brunei Darussalam | bn |
| Bulgaria | bg |
| Burkina Faso | bf |
| Burma (no longer exists) | bu |
| Burundi | bi |
| Cambodia | kh |
| Cameroon | cm |
| Canada | ca |
| Cape Verde | cv |
| Cayman Islands | ky |
| Central African Republic | cf |
| Chad | td |
| Chile | cl |
| China | cn |
| Christmas Island | cx |
| Cocos (Keeling) Islands | cc |
| Colombia | co |
| Comoros | km |
| Congo | cg |
| Cook Iislands | ck |
| Costa Rica | cr |
| Croatia | hr |
| Cuba | cu |
| Cyprus | cy |
| Czech Republic | cz |
| Czechoslovakia (no longer exists) | cs |
| Côte D'ivoire (Ivory Coast) | ci |
| Democratic Yemen (no longer exists) | yd |
| Denmark | dk |
| Djibouti | dj |
| Dominica | dm |
| Dominican Republic | do |
| East Timor | tp |
| Ecuador | ec |
| Egypt | eg |
| El Salvador | sv |
| Equatorial Guinea | gq |
| Eritrea | er |
| Estonia | ee |
| Ethiopia | et |
| Falkland Islands (Malvinas) | fk |
| Faroe Islands | fo |
| Fiji | fj |
| Finland | fi |
| France | fr |
| French Guiana | gf |
| French Polynesia | pf |
| French Southern Territories | tf |
| Gabon | ga |
| Gambia | gm |
| Georgia | ge |
| German Democratic Republic (no longer exists) | dd |
| Germany | de |
| Ghana | gh |
| Gibraltar | gi |
| Greece | gr |
| Greenland | gl |
| Grenada | gd |
| Guadeloupe | gp |
| Guam | gu |
| Guatemala | gt |
| Guinea | gn |
| Guinea-Bissau | gw |
| Guyana | gy |
| Haiti | ht |
| Heard & McDonald Islands | hm |
| Honduras | hn |
| Hong Kong | hk |
| Hungary | hu |
| Iceland | is |
| India | in |
| Indonesia | id |
| Iraq | iq |
| Ireland | ie |
| Islamic Republic of Iran | ir |
| Israel | il |
| Italy | it |
| Jamaica | jm |
| Japan | jp |
| Jordan | jo |
| Kazakhstan | kz |
| Kenya | ke |
| Kiribati | ki |
| Korea, Democratic People's Republic of | kp |
| Korea, Republic of | kr |
| Kuwait | kw |
| Kyrgyzstan | kg |
| Lao People's Democratic Republic | la |
| Latvia | lv |
| Lebanon | lb |
| Lesotho | ls |
| Liberia | lr |
| Libyan Arab Jamahiriya | ly |
| Liechtenstein | li |
| Lithuania | lt |
| Luxembourg | lu |
| Macau | mo |
| Madagascar | mg |
| Malawi | mw |
| Malaysia | my |
| Maldives | mv |
| Mali | ml |
| Malta | mt |
| Marshall Islands | mh |
| Martinique | mq |
| Mauritania | mr |
| Mauritius | mu |
| Mayotte | yt |
| Mexico | mx |
| Micronesia | fm |
| Moldova, Republic of | md |
| Monaco | mc |
| Mongolia | mn |
| Monserrat | ms |
| Morocco | ma |
| Mozambique | mz |
| Myanmar | mm |
| Namibia | na |
| Nauru | nr |
| Nepal | np |
| Netherlands Antilles | an |
| Netherlands | nl |
| Neutral Zone (no longer exists) | nt |
| New Caledonia | nc |
| New Zealand | nz |
| Nicaragua | ni |
| Niger | ne |
| Nigeria | ng |
| Niue | nu |
| Norfolk Island | nf |
| Northern Mariana Islands | mp |
| Norway | no |
| Oman | om |
| Pakistan | pk |
| Palau | pw |
| Panama | pa |
| Papua New Guinea | pg |
| Paraguay | py |
| Peru | pe |
| Philippines | ph |
| Pitcairn | pn |
| Poland | pl |
| Portugal | pt |
| Puerto Rico | pr |
| Qatar | qa |
| Romania | ro |
| Russian Federation | ru |
| Rwanda | rw |
| Réunion | re |
| Saint Lucia | lc |
| Samoa | ws |
| San Marino | sm |
| Sao Tome & Principe | st |
| Saudi Arabia | sa |
| Senegal | sn |
| Seychelles | sc |
| Sierra Leone | sl |
| Singapore | sg |
| Slovakia | sk |
| Slovenia | si |
| Solomon Islands | sb |
| Somalia | so |
| South Africa | za |
| South Georgia and the South Sandwich Islands | gs |
| Spain | es |
| Sri Lanka | lk |
| St. Helena | sh |
| St. Kitts and Nevis | kn |
| St. Pierre & Miquelon | pm |
| St. Vincent & the Grenadines | vc |
| Sudan | sd |
| Suriname | sr |
| Svalbard & Jan Mayen Islands | sj |
| Swaziland | sz |
| Sweden | se |
| Switzerland | ch |
| Syrian Arab Republic | sy |
| Taiwan, Province of China | tw |
| Tajikistan | tj |
| Tanzania, United Republic of | tz |
| Thailand | th |
| Togo | tg |
| Tokelau | tk |
| Tonga | to |
| Trinidad & Tobago | tt |
| Tunisia | tn |
| Turkey | tr |
| Turkmenistan | tm |
| Turks & Caicos Islands | tc |
| Tuvalu | tv |
| Uganda | ug |
| Ukraine | ua |
| Union of Soviet Socialist Republics (no longer exists) | su |
| United Arab Emirates | ae |
| United Kingdom (Great Britain) | gb |
| United States Minor Outlying Islands | um |
| United States Virgin Islands | vi |
| United States | us |
| Uruguay | uy |
| Uzbekistan | uz |
| Vanuatu | vu |
| Vatican City State (Holy See) | va |
| Venezuela | ve |
| Viet Nam | vn |
| Wallis & Futuna Islands | wf |
| Western Sahara | eh |
| Yemen | ye |
| Yugoslavia | yu |
| Zaire | zr |
| Zambia | zm |
| Zimbabwe | zw |
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.