Skip to main content
Targeting is controlled entirely through your proxy username. Append tokens after your username, separated by hyphens. All tokens are optional. With none, you get a rotating IP from anywhere in the pool.
Country, state, and city are layered: each narrows the one before it. State and city can be combined, and you should combine them to pin a specific city. Many city names repeat across states (for example, Portland exists in Oregon, Maine, and several other states), so the state is what disambiguates which city you reach.

​
Tokens

Use lowercase ISO country codes. Include the state with a city to reach the city you intend (for example -country-us-state-california-city-losangeles); without a state, a repeated city name resolves to a single default location.

​
Examples

​
Common locations

A few popular locations to get you started. Any ISO 3166-1 alpha-2 country code works, so this list is illustrative, not exhaustive. See all available locations for the full country list.
Country targeting spans 195+ countries. State and city targeting work where the pool has coverage. If a specific city returns no exits, broaden to the country.

​
Common networks (ASN)

Target a specific carrier with -asn-<n>. ASN selects by network operator, so an exit can be anywhere that operator runs. Combine it with -country-, -state-, or -city- to also pin a location. The pool spans thousands of networks across every country. The table below is a small selection of common consumer carriers and is not exhaustive, any valid ASN works with -asn-<n>.
Prefer a carrier’s mobile network for broad coverage: mobile ASNs (for example Verizon Wireless 6167, AT&T Mobility 20057, T-Mobile 21928) have exits nationwide and honor city targeting anywhere. Fixed and cable ASNs (for example Verizon Fios 701, AT&T wireline 7018) only have exits in their service areas, so pairing one with a city it does not serve falls back to another exit on that network. See each country’s page under Available Locations for its full network list. To confirm the exit’s network, check ip-api.com rather than ipinfo.io, which can mislabel residential ASNs.

​
Notes

  • Country codes follow the ISO 3166-1 alpha-2 standard.
  • -state- and -city- work together. Include the state when targeting a city, since city names are not unique within a country. See all available locations for each country’s states and the cities within them.
  • The more specific your targeting, the smaller the available pool, which can affect availability and speed in some locations.
  • Targeting tokens are case-insensitive, but lowercase is recommended.

Next: Sessions

Keep the same IP with sticky sessions, or rotate on every request.