Geo-Targeting
DocsGeo-Targeting

Geo-Targeting

Route traffic through specific countries, states, cities, ZIP codes, or ASNs by appending parameters to your username.

Parameter Syntax

Geo parameters are appended to the username using a double underscore (__) as a separator from the base login. Multiple parameters are separated by semicolons (;).

Format
USERNAME__param1.value1;param2.value1,value2:PASSWORD@proxy.raxyproxy.com:823
ParameterValuesMulti-value2× billing?
crLowercase ISO-2 country codesComma-separated: cr.us,gb,deNo — free for all types
nocrCountries to excludeComma-separated: nocr.cn,ruNo — free for all types
stateFull state name, lowercase, no spacesComma-separated: state.california,texasYes — Residential, Mobile, Datacenter
cityFull city name, lowercase, no spacesComma-separated: city.losangeles,newyorkYes — Residential, Mobile, Datacenter
zip5-digit US ZIP codesComma-separated: zip.10001,90001Yes — Residential, Mobile, Datacenter
asnASN number only — no "AS" prefixComma-separated: asn.15169,16509Yes — Residential, Mobile, Datacenter

Premium Residential exception

Premium Residential proxies have no 2× surcharge for any targeting level — including state, city, ZIP, and ASN. This makes them the most cost-effective choice for precise geo-targeting.

Country

Use lowercase 2-letter ISO 3166-1 alpha-2 codes. Country filtering is free for all proxy types.

Include countries
# US only
http://USERNAME__cr.us:PASSWORD@proxy.raxyproxy.com:823

# US, UK, and Germany
http://USERNAME__cr.us,gb,de:PASSWORD@proxy.raxyproxy.com:823
Exclude countries
# Exclude China and Russia — use all other countries
http://USERNAME__nocr.cn,ru:PASSWORD@proxy.raxyproxy.com:823

You cannot combine cr and nocr in the same credential. Use one or the other.

State / Region

State targeting requires a country filter (cr). Format: full state name, lowercase, no spaces or hyphens.

State targeting
# California only
http://USERNAME__cr.us;state.california:PASSWORD@proxy.raxyproxy.com:823

# California or Texas
http://USERNAME__cr.us;state.california,texas:PASSWORD@proxy.raxyproxy.com:823
StateCode to use
Californiacalifornia
New Yorknewyork
Texastexas
Floridaflorida
Illinoisillinois
District of Columbiadistrictofcolumbia
Washingtonwashington

City

City targeting also requires a country filter. Format: full city name, lowercase, no spaces.

City targeting
# Los Angeles only
http://USERNAME__cr.us;city.losangeles:PASSWORD@proxy.raxyproxy.com:823

# New York or Chicago
http://USERNAME__cr.us;city.newyork,chicago:PASSWORD@proxy.raxyproxy.com:823

# London
http://USERNAME__cr.gb;city.london:PASSWORD@proxy.raxyproxy.com:823

ZIP Code

5-digit US ZIP codes. Requires cr.us.

ZIP targeting
# New York City 10001
http://USERNAME__cr.us;zip.10001:PASSWORD@proxy.raxyproxy.com:823

# Multiple ZIPs
http://USERNAME__cr.us;zip.10001,90001,60601:PASSWORD@proxy.raxyproxy.com:823

ASN

Target IPs belonging to a specific Autonomous System. Use the numeric ASN only — do not include the "AS" prefix.

ASN targeting
# Google LLC (ASN 15169)
http://USERNAME__cr.us;asn.15169:PASSWORD@proxy.raxyproxy.com:823

# Multiple ASNs
http://USERNAME__cr.us;asn.15169,16509:PASSWORD@proxy.raxyproxy.com:823

Combining Parameters

Parameters chain with semicolons. Country must come first (after __).

Full example — US, California, Los Angeles
http://USERNAME__cr.us;state.california;city.losangeles:PASSWORD@proxy.raxyproxy.com:823
With sticky sessid
http://USERNAME__cr.us;state.california;sessid.myuser42:PASSWORD@proxy.raxyproxy.com:823

Billing Rules

ParameterResidentialMobileDatacenterPremium Residential
cr / nocr1× (free)1× (free)1× (free)1× (free)
state1× (free)
city1× (free)
zip1× (free)
asn1× (free)

The 2× surcharge means 1 GB of actual traffic consumes 2 GB from your quota. See Traffic & 2× Billing for examples.

Format Rules

  • Country codes: lowercase 2-letter ISOus, gb, de
  • States: full name, lowercase, no spacescalifornia, newyork, districtofcolumbia
  • Cities: full name, lowercase, no spaceslosangeles, newyork, sanfrancisco
  • ZIP: 5-digit string10001
  • ASN: numeric only, no "AS" prefix15169, not AS15169
  • Separator between username and params: __ (double underscore)
  • Separator between params: ; (semicolon)
  • Multiple values within a param: , (comma)