One Korean city or anywhere in South Korea: city targeting
You can ask for a Korean residential IP in one city rather than anywhere in the country. Put the city in the username, <login>-country-kr-city-<city>, with its key from the city list in your dashboard. With the country alone, the gateway picks any of the 6M+ Korean residential IPs; adding a city narrows the choice to IPs that geolocate in that city. Both cost the same per GB, on every tier.
| What you set | Username | Which IPs you get | Price |
|---|---|---|---|
| South Korea | <login>-country-kr | any Korean IP, from 6M+ residential | same per GB |
| A province | <login>-country-kr-region-<region> | IPs in that province | same per GB |
| A city from the dashboard list | <login>-country-kr-city-<city> | IPs that geolocate in that city | same per GB |
| ZIP code or ASN | not offered | – | – |
The city is the finest level. Names go in lowercase, with underscores for spaces. The full list of Korean cities is in your dashboard. When no exit can be connected in the city you chose, the gateway answers 502 Bad Gateway; it does not fall back to a nearby city. The carrier is not a targeting option.
# country only
curl -x gate.proxyfield.io:7000 -U "<login>-country-kr:<password>" https://api.ipify.org
# a city: its key from the dashboard list
curl -x gate.proxyfield.io:7000 -U "<login>-country-kr-city-<city>:<password>" https://api.ipify.org
# where the exit IP geolocates (a third-party lookup)
curl -x gate.proxyfield.io:7000 -U "<login>-country-kr-city-<city>:<password>" https://ipinfo.io/jsonThe last command returns the city, region and country a geolocation database gives the exit IP. City-level geolocation is approximate, and databases disagree more on cities than on countries, so trust "country": "KR" and check the city before a test that depends on Seoul. The proxy checker tests up to 100 proxies per check; your list and results are not stored.
Session keys go after the location: -session-<id> and -ttl-<seconds> (30 to 129,600 seconds, 20 minutes by default), as in gate.proxyfield.io:7000:<login>-country-kr-city-<city>-session-he9f2qga-ttl-600:<password>. See the location targeting docs.