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: 2xt-customer-a1b2-proxy-my-scraper Username with Geo-Targeting: 2xt-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) (coming soon). 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 (-state) US Only

Target a specific state within the United States.
  • Format: -state-[code]
  • Value: A 2-letter state code (e.g., ca for California, ny for New York).
  • Dependencies: Requires -country-us to be present in the username.
  • Example Username: ...-my-scraper-country-us-state-ca
  • 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) US Only (Coming Soon)

Target a specific ZIP code within the United States. Ideal for hyper-local data collection.
  • Format: -zip-[code]
  • Value: A 5-digit US ZIP code.
  • Dependencies: Requires -country-us. Mutually exclusive with -state and -city.
  • 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

This parameter controls the network origin of the proxy.

​
ASN (-asn) (Coming Soon)

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.