Skip to main content
With the Unlimited Residential package you control where your proxies exit (country, city, or state) by appending keywords to your proxy username — no change to the host or port is needed. (To keep the same IP across requests, see Unlimited Residential - Sticky sessions.)

Country targeting

To route through a specific country, append -country- followed by the 2-letter ISO country code (uppercase) to the end of your proxy username. Examples:
  • yourusername-country-US — United States
  • yourusername-country-GB — United Kingdom
  • yourusername-country-DE — Germany

City targeting

To narrow a country down to a specific city, append -city- followed by the city name (lowercase, no spaces) after the -country- code. Examples:
  • yourusername-country-US-city-newyork — New York City, United States
  • yourusername-country-GB-city-london — London, United Kingdom
  • yourusername-country-DE-city-berlin — Berlin, Germany

State targeting

To narrow a country down to a specific state, append -state- followed by the 2-letter state code (uppercase, no spaces) after the -country- code. Examples:
  • yourusername-country-US-state-CA — California, United States
  • yourusername-country-US-state-TX — Texas, United States
  • yourusername-country-US-state-FL — Florida, United States
The dashboard Proxy Setup screen for Unlimited Residential builds country and city usernames. State targeting is supported by appending the -state- keyword to your username as shown above, so build the state username yourself if the dropdown does not offer it.
You can target either a city or a state, but not both at the same time.
Not all countries, cities, and states are supported. To check whether a specific location is available, reach out to our support team.
You can also build these usernames from the dashboard: go to the Proxy Setup section, choose your desired country or city from the dropdowns, and the appended characters are generated at the end of your username for you to copy and paste into your program. State targeting is supported but is not offered by the Proxy Setup dropdowns — append the -state- keyword yourself as shown above.