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 countries 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 thru it.

EU Countries targeting

Bright Data proxy networks as well as our Web Unlocker 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

Residential proxies only. For DC & ISP networks you need to configure your zone and select the cities you would like to have proxies in. Using this parameter without pre-selection in DC & ISP is not permitted

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

For relevant counties (e.g., USA and Australia), you can target a state within a country by adding to the username-country-country_code-state-state_code. Use only two-letter state codes in lowercase.

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>