Targeting

Route residential traffic by country, state, or city

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-<n>]
Password: <your password>

Modifiers stack in this order: country → state → city. Each level is independent — stop wherever you need to. To get a random IP at a broader level, just omit the narrower modifier.

Country targeting

Use any ISO 3166-1 alpha-2 country code. Lowercase.

# Germany — via the EU gateway
curl -x "http://adminpcowe-country-de:[e-mail]:13337" \
  https://api.ipify.org

# Japan — via the APAC gateway for lower latency
curl -x "http://adminpcowe-country-jp:[e-mail]:13337" \
  https://api.ipify.org

# Netherlands
curl -x "http://adminpcowe-country-nl:[e-mail]:13337" \
  https://api.ipify.org

Match the regional gateway to your target country for lowest latency: US-style targets → pr-us, European → pr-eu, APAC → pr-sg. Cross-region works fine but adds a hop.

State targeting

Available for countries with state / regional subdivisions (US, Canada, Australia, Germany, Brazil, etc.). Use the standard subdivision code.

# Any IP in California (random city)
curl -x "http://adminpcowe-country-us-state-ca:[e-mail]:13337" \
  https://api.ipify.org

# Any IP in New York state
curl -x "http://adminpcowe-country-us-state-ny:[e-mail]:13337" \
  https://api.ipify.org

# Ontario, Canada
curl -x "http://adminpcowe-country-ca-state-on:[e-mail]:13337" \
  https://api.ipify.org

Omitting city- means “any city in that state” — the network picks one at random.

City targeting

Append -city-<n> for a specific city. City is lowercased and concatenated (no spaces).

City targeting works with or without state- — if you know the city, you can skip the state layer:

# Westlake Village, CA (state omitted)
curl -x "http://adminpcowe-country-us-city-westlakevillage:[e-mail]:13337" \
  https://api.ipify.org

# Pleasanton, CA (state omitted)
curl -x "http://adminpcowe-country-us-city-pleasanton:[e-mail]:13337" \
  https://api.ipify.org

# Explicit state (when disambiguation is needed)
curl -x "http://adminpcowe-country-us-state-ca-city-pleasanton:[e-mail]:13337" \
  https://api.ipify.org

Add state- only when two cities share a name across states (e.g. “Springfield”). Otherwise, country-<cc>-city-<n> is the simplest form.

City name format

• All lowercase
• No spaces, apostrophes, or hyphens (concatenate): westlakevillage, sanfrancisco, newyorkcity
• Accents stripped: zurich not zürich

If a city isn’t recognised you’ll receive a 454 invalid city code response — see error codes.

ASN targeting

asn-<number> pins your IP to a specific ISP by its Autonomous System Number. Useful when a target correlates IP behaviour with the ISP — ad verification for specific carriers, testing CDN peering, simulating traffic from a particular network.

# Any AT&T customer in the US (ASN 7018)
curl -x "http://adminpcowe-country-us-asn-7018:[e-mail]:13337" \
  https://api.ipify.org

# Comcast in any US city (ASN 7922)
curl -x "http://adminpcowe-country-us-asn-7922:[e-mail]:13337" \
  https://api.ipify.org

Common US ASNs

ASN	ISP
7018	AT&T
7922	Comcast
701	Verizon
20115	Charter / Spectrum
22773	Cox
209	CenturyLink

Find the ASN for any IP using whois, bgp.he.net, or ipinfo.io.

Stacking ASN with geo targeting

ASN combines with every other modifier. Narrow down to a specific ISP inside a specific city:

# Comcast subscribers in Pleasanton, CA
curl -x "http://adminpcowe-country-us-city-pleasanton-asn-7922:[e-mail]:13337" \
  https://api.ipify.org

# AT&T in New York state
curl -x "http://adminpcowe-country-us-state-ny-asn-7018:[e-mail]:13337" \
  https://api.ipify.org

The narrower the combined targeting, the smaller the pool. For high-concurrency workloads, keep at least one level wide.

Targeting granularity cheat sheet

Target	Username format
Random IP, any country	adminpcowe
Random IP in any US city	adminpcowe-country-us
Random IP in any NY city	adminpcowe-country-us-state-ny
Specific city (state skipped)	adminpcowe-country-us-city-westlakevillage
Specific city within state	adminpcowe-country-us-state-ca-city-pleasanton
Specific ISP (AT&T)	adminpcowe-country-us-asn-7018
ISP + city combined	adminpcowe-country-us-city-pleasanton-asn-7922

To randomize at a given level, simply don’t add the narrower modifier.

Combining with sessions

Any targeting level can be combined with a sticky session and TTL:

adminpcowe-country-us-city-westlakevillage-session-5s5d4xud-ttl-15:maskxsndyb

That pins a Westlake Village IP for 15 minutes across every request using session 5s5d4xud. See Sessions.

Full code examples

Python

import requests

# Target: Westlake Village, California
username = "adminpcowe-country-us-city-westlakevillage"
proxy = f"http://{username}:[e-mail]:13337"
proxies = {"http": proxy, "https": proxy}

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

Quick-copy format

For tools that accept host:port:user:pass:

pr-eu.proxies.fo:13337:adminpcowe-country-us-city-westlakevillage:maskxsndyb
pr-eu.proxies.fo:13337:adminpcowe-country-us-city-pleasanton:maskxsndyb
pr-eu.proxies.fo:13337:adminpcowe-country-us-state-ny:maskxsndyb
pr-us.proxies.fo:13337:adminpcowe-country-us:maskxsndyb
pr-us.proxies.fo:13337:adminpcowe-country-us-asn-7018:maskxsndyb
pr-us.proxies.fo:13337:adminpcowe-country-us-city-pleasanton-asn-7922:maskxsndyb
pr-sg.proxies.fo:13337:adminpcowe-country-jp:maskxsndyb

Troubleshooting

454 invalid country code

The country code isn’t recognised. Check it’s lowercase ISO 3166-1 alpha-2 (us, not US or usa).

454 invalid state code

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).

454 invalid city code

The city isn’t recognised, or no IPs are available for that city. Check the city name is lowercase and concatenated (no spaces, hyphens, or apostrophes). If the city is valid but has low IP availability, drop the city- modifier to get any IP in the state or country.

454 invalid ASN

The asn-<number> value isn’t in the supported ASN set, or has no IPs available for your geo targeting. Verify the ASN with whois or bgp.he.net, and try widening the geo (e.g. remove city- or state-) to see if IPs are available in that ASN further up.

Slow or timing out

Narrow targeting means a smaller pool. For high concurrency, widen to state or country level — or split workloads across regional gateways.