Skip to main content

​
Country Targeting

You can target a specific country by adding a country code to your username, like username-country-country_code. Use only two-letter country codes in lowercase.
Shell
curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password>

​
Default countries’ selection

In all Bright Data shared pool proxies: Datacenter, ISP, Residential and Mobile share pools (also known as “Rotating proxies”) we offer a default country selection during zone configuration. When a country(s) is selected, Bright Data will attempt to allocate a peer from the selected default countries. The allocation sequence is as follows: If there are default countries configured:
  1. Select a random country from the default countries list.
  2. Attempt to allocate a peer in that country
  3. If peer found: route request to the peer
  4. If peer not found: fail the request and reply with error
In case there are no default countries selected, Bright Data will allocate a random proxy peer from the pool and route the request through it.

​
EU Countries targeting

Bright Data proxy networks as well as our Unlocker API allow random peer selection specifically from EU-member countries via the use of the -country-eu flag. When needing to target EU peers, this will improve success rates over targeting from just one EU country, while still keeping the peer within the EU.

​
City Targeting

City targeting works best in Residential & Mobile proxies. City targeting in Datacenter & ISP proxies has deprecated and we do not recommend using it.
You can target a specific city within a country by adding a city name to the username, like username-country-country_code-city-city_code. The city_codemust be in lowercase only and have no spaces, for example -city-sanfrancisco
Shell
curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us-city-sanfrancisco:<zone_password>

​
State Targeting

Residential proxies only
You can target a specific region or subdivision by adding the parameter -state-<state_code> to your username string. We utilize the ISO 3166-2 standard for state targeting. While this includes standard 2-letter codes (e.g., US states), we also support 3-letter and numeric codes as defined by the standard for other regions.
Always verify the correct subdivision code using the ISO 3166-2 standard. Ensure the code is entered in lowercase.
# Targeting New York (ny)
curl "[https://example.com](https://example.com)" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us-state-ny:<zone_password>

​
ASN Targeting

Residential proxies only
You can target a specific ASN from the list of ASNs. Choosing an ASN country is done as following: -asn-ASN_NUMBER
Shell
curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-56386:<zone_password>

​
ZIP Code Targeting

Residential proxies only
You can target proxy peers by a ZIP code of a specific area. Here is an example of targeting an IP from Memphis, US and zip code 12345:
Shell
curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-city-memphis-zip-12345:<zone_password>