Skip to main content
Geo-targeting allows you to control the geographic location of the exit IP address for your requests. This is essential for accessing geo-restricted content, collecting localized data, and ad verification. You can control geo-targeting by appending special parameters directly to your proxy’s username. Base Username: cat-customer-a1b2-proxy-my_scraper Username with Geo-Targeting: cat-customer-a1b2-proxy-my_scraper-country-de-city-berlin

​
Targeting Logic

Our gateway processes geo-parameters with the following rules:
  • Specificity Wins: The most specific parameter is always used. For example, if you provide both -city and -country, the city will be prioritized.
  • Dependencies: Some parameters require others. For example, you cannot target a city without specifying a country.
  • Mutual Exclusivity: You can either target by geography (country, state, city, zip) OR by network (asn, isp). You cannot use both in the same request.

​
Geographic Targeting Parameters

These parameters control the physical location of the proxy.

​
Country (-country)

This is the most common targeting parameter. It allows you to select an IP from a specific country.
  • Format: -country-[code]
  • Value: A 2-letter ISO 3166-1 alpha-2 country code (e.g., us, de, gb).
  • Dependencies: None.
  • Example Username: ...-my_scraper-country-de
  • Result: Your request will be routed through a random IP in Germany.
  • View full list of supported countries

​
State / Region (-state)

Target a specific state or region within the selected country.
  • Format: -state-[code]
  • Value: A state or region name (e.g., california for California, newyork for New York).
  • Dependencies: Requires -country to be present in the username.
  • Example Username: ...-my_scraper-country-us-state-california
  • Result: Your request will be routed through an IP in California.
  • View full list of US states

​
City (-city)

Target a specific city.
  • Format: -city-[name]
  • Value: The name of the city in lowercase, with spaces removed (e.g., newyork, sanfrancisco).
  • Dependencies: Requires a -country parameter. Can be combined with -state for disambiguation.
  • Example (Simple): ...-my_scraper-country-fr-city-paris
  • Example (With State): ...-my_scraper-country-us-state-il-city-springfield
  • Result: Your request will be routed through an IP in the specified city.
  • Note on Ambiguity: If a country has multiple cities with the same name, you must provide a -state to clarify. Otherwise, the gateway will return an error.

​
ZIP Code (-zip)

Target a specific ZIP code. Ideal for hyper-local data collection.
  • Format: -zip-[code]
  • Value: A ZIP code.
  • Dependencies: Requires -country. Can be combined with -state and -city for more precise targeting.
  • Example Username: ...-my_scraper-country-us-zip-90210
  • Result: Your request will be routed through an IP in the Beverly Hills area.

​
Network Targeting Parameters

These parameters control the network origin of the proxy. They are mutually exclusive with all geographic parameters.

​
ASN (-asn)

Target a specific Internet Service Provider (ISP) by its Autonomous System Number (ASN).
  • Format: -asn-[number]
  • Value: The numerical ASN of the provider (e.g., 7922 for Comcast).
  • Dependencies: Mutually exclusive with all geographic parameters (-country, -state, -city, -zip).
  • Example Username: ...-my_scraper-asn-7922
  • Result: Your request will be routed through an IP belonging to the Comcast network.
  • Tip: You can find ASN numbers for major providers on sites like ipinfo.io.

​
ISP (-isp) - Mobile Proxies Only

Target a specific mobile network operator by its numeric ISP code. Available for mobile proxies only.
  • Format: -isp-[code]
  • Value: The numeric code of the mobile operator as provided in the ISP reference list (e.g., 310260 for T-Mobile US).
  • Dependencies: Mutually exclusive with all geographic parameters (-country, -state, -city, -zip). Available on mobile proxies only.
  • Example Username: ...-my_scraper-isp-310260
  • Result: Your request will be routed through an IP on the T-Mobile US network.
  • Note: The ISP code is a numeric identifier, not a name slug. Use the code from the ISP selector in your proxy dashboard.