Skip to main content
Proxies how-to

Target a country, city, carrier or OS

Targeting is written into the proxy username as key-value pairs: country-us, city-losangeles, asn-7922, os-windows. Leave a parameter out and the network chooses for you; the Generate panel on the Residential Proxy page writes the username for you if you prefer.

Written By Carmine Cella

Last updated 1 day ago

Targeting is written into the proxy username as key-value pairs: country-us, city-losangeles, asn-7922, os-windows. Leave a parameter out and the network chooses for you; the Generate panel on the Residential Proxy page writes the username for you if you prefer.

In the dashboard

On Residential Proxy, Location takes Anywhere, a continent (Europe gives each line a different European country) or one or more countries. Type is Rotating or Sticky; Advanced settings adds Region and City (pick a country first), Session time in minutes, Operating system and ASN. Regions and cities narrow the countries you picked by name; continents stay as they are.

The Generate panel: Location, Type and the Advanced settings with Region, City, Session time, Operating system and ASN

The parameters

You wantAdd to the usernameExample
A countrycountry- + two-letter codenetwork-residential-country-de
Several countries, any of themcodes separated by commasnetwork-residential-country-de,gb,us
A region or stateregion- + the region code (needs country)network-residential-country-us-region-texas
A citycity- + the city code (needs country)network-residential-country-gb-region-england-city-london
A carrier or ISPasn- + the AS number (needs country)network-residential-country-de-asn-3320
A device operating systemos- + windows, macos, linux, android or iosnetwork-residential-country-fr-os-windows
The same IP for a whilesession- + any id, and ttl- + minutes (1 to 1,440)…-country-us-session-a91f3-ttl-60
Mobile carrier IPsstart with pool-mobile instead (a mobile plan)pool-mobile-country-us-asn-21928
UDP over SOCKS5start with network-residential-pool-udpnetwork-residential-pool-udp-country-de

Where the codes come from

Region and city values are codes, not names: california, losangeles, england. The Region and City dropdowns in the Generate panel show them; the User API lists them per country. A guessed code gives a 417 error.

Carrier codes are AS numbers without the "AS": Deutsche Telekom 3320, Comcast 7922, T-Mobile US 21928, Verizon Wireless 22394, AT&T 20057, Vodafone UK 25135, TIM 3269.

Rules worth knowing

  • The pool selector (network-residential, pool-mobile) comes first; the rest can be in any order.
  • city and asn cannot be combined; use region with asn instead.
  • ttl without session does nothing.
  • os-android or os-ios picks a residential device with that system; for carrier IPs use the mobile pool.
  • Narrow targets have smaller pools: if a city gives no IP, widen one step.

Was this helpful?

Still need help? Ask the team