Skip to main content

​
Country Targeting

You can target a specific country in one of two ways:
  • Username parameter: add a country code to your username, like username-country-country_code.
  • Proxy header: send the brd-exit-country header with the country code, like brd-exit-country: country_code, and keep your username unchanged.
In both cases, use only two-letter country codes in lowercase.
The brd-exit-country value is sent with --proxy-header, so it goes to the proxy only and is not forwarded to the target website.

​
Default countries’ selection

In all Bright Data shared pool proxies: Datacenter, ISP and Residential shared 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 Web 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 with Residential. City targeting for Datacenter and ISP proxies has been deprecated and is no longer available.
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, or by sending the brd-exit-country and brd-exit-city headers. The city_code must be in lowercase only and have no spaces, for example -city-sanfrancisco or brd-exit-city:sanfrancisco.

​
State Targeting

Residential proxies only
You can target a specific region or subdivision by adding the parameter -state-<state_code> to your username string, or by sending the brd-exit-country and brd-exit-state headers. 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.

​
ASN Targeting

Residential proxies only
You can target a specific ASN from the list of ASNs. Choosing an ASN is done by adding -asn-ASN_NUMBER to the username, or by sending the brd-exit-asn header.

​
ZIP Code Targeting

Residential proxies only
You can target proxy peers by a ZIP code of a specific area. Use the -zip-<zip_code> username parameter or the brd-exit-zipcode header. Here is an example of targeting an IP from Memphis, US and zip code 12345: