Skip to main content
Targeting is controlled entirely through username modifiers. No separate endpoints per country — all 180+ countries are reachable from any regional gateway.

​
Format

Username: <base>-country-<cc>[-state-<sc>][-city-<cc>]
Password: <your password>
Modifiers stack in this order: country → state → city. You can stop at any level — country-us alone targets the whole US, country-us-state-ny narrows to New York state, and adding city-nyc narrows further.

​
Country targeting

Use any ISO 3166-1 alpha-2 country code. Lowercase. 
# Germany
curl -x "http://acme-country-de:PASSWORD@pr-eu.proxies.fo:13337" https://api.ipify.org

# Japan (via the APAC gateway for lower latency)
curl -x "http://acme-country-jp:PASSWORD@pr-sg.proxies.fo:13337" https://api.ipify.org

# Netherlands
curl -x "http://acme-country-nl:PASSWORD@pr-eu.proxies.fo:13337" https://api.ipify.org
Match the regional gateway to your target country for lowest latency: US countries → pr-us, European countries → pr-eu, APAC → pr-sg. Cross-region is supported but adds a hop.

​
State targeting

Available for countries with state / region subdivisions (US, Canada, Australia, Germany, Brazil, etc.). Use the standard regional subdivision code. 
# California
curl -x "http://acme-country-us-state-ca:PASSWORD@pr-us.proxies.fo:13337" \
  https://api.ipify.org

# New York
curl -x "http://acme-country-us-state-ny:PASSWORD@pr-us.proxies.fo:13337" \
  https://api.ipify.org

# Ontario, Canada
curl -x "http://acme-country-ca-state-on:PASSWORD@pr-us.proxies.fo:13337" \
  https://api.ipify.org

​
City targeting

Append -city-<code> for city-level targeting. Use a specific city code, or ran to get a random city within the targeted state. 
# Specific city
curl -x "http://acme-country-us-state-ny-city-nyc:PASSWORD@pr-us.proxies.fo:13337" \
  https://api.ipify.org

# Random city in New York state
curl -x "http://acme-country-us-state-ny-city-ran:PASSWORD@pr-us.proxies.fo:13337" \
  https://api.ipify.org
City availability depends on the size of the residential pool in that area. If a specific city has too few IPs to serve your request volume, use city-ran or drop to state-level targeting.

​
Combining with sessions

Any targeting can be combined with a sticky session and TTL: 
Username: acme-country-us-state-ny-city-ran-session-asdas1-ttl-15
Password: <your password>
This pins an NY IP for 15 minutes across every request that uses session-asdas1. See Sessions for the full mechanics.

​
Full code examples

import requests

# Target: random city in NY, US
username = "acme-country-us-state-ny-city-ran"
proxy = f"http://{username}:PASSWORD@pr-us.proxies.fo:13337"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://api.ipify.org", proxies=proxies)
print(r.text)

​
Troubleshooting

The country code isn’t recognised. Check it’s lowercase ISO 3166-1 alpha-2 (us, not US or usa).
The state code isn’t recognised for that country. Use standard regional subdivision codes (e.g. ny, ca for US states, on, qc for Canadian provinces).
The city isn’t recognised, or has no IPs available. Try city-ran to let the network pick any city in the targeted state.
Narrow targeting means a smaller pool. For high concurrency, widen to state or country level — or split workloads across regional gateways.