Residential Proxies: How to guides

Take a deeper look into Residential Proxy and explore the different targeting options, control panel configurations, and more.

Getting Started

If you haven't yet seen our Residential Proxy Getting started guide, you'll want to go there first to briefly review how to create a Residential proxy network, send your first request, explore the control panel, and more basic actions.

How to: for All Proxy networks

Learn how to target a specific country or city when sending your request, set a limit on bandwidth consumption, integrations, statistics, and more

How to: Residential Proxy specific 

Explore how to target ASN specific IPs, Proxy Peers, OS's, and how to best browse Chinese-based domains. 

Targeting an ASN specific IP 

This feature can be enabled by adding the ASN parameter to your Zone configuration, under Geolocation Targeting.  


Once the configuration is saved, the ASN flag can be added to the Zone's credentials
and be integrated when using the Residential proxies. For example:

curl --proxy --proxy-user brd-customer-<USERNAME>-zone-<ZONE>-asn-<ASN number>:<PASSWORD> "<TARGET SITE>"

Note: Values for <ASN number> can be found here.


Targeting Residential IP groups (gIPs) 

Dedicated Residential IPs can be selected in the form of gIPs. They can be allocated under the zone's configuration page by selecting a "Dedicated" IP type and choosing a number of gips. Also targeting a specific domain is required.


Once the configuration is saved, selecting "Show allocated Dedicated residential IPs" will provide 
a list of hash values that represent group IPs.

These values can be used to target a specific gip. For example:

curl --proxy --proxy-user brd-customer-<USERNAME>-zone-<ZONE>-gip-<gip_hash_value>:<PASSWORD> "<TARGET SITE>"

Long-Session Peers

Long-Session Peers enables you to maintain a stable IP address for an extended period, ensuring seamless and consistent scraping operations. Unlike regular Residential IPs, where the IP can rotate at any moment if the peer unexpectedly disconnects, Long-Session Peers provide continuous sessions.

Enabling Long-Session Peers

Simply, go to an existing Residential zone or open a new one and toggle on the ‘Long-session peers’ feature. Now your future requests will only be routed through known long-lasting peers. 
Note: This feature does add an extra cost for the zone when enabled

Where Are These Peers From?

Our Residential peers' pool consists of real users around the world who opt-in to use our product. As part of the opt-in, we utilize the IPs of these real users during their "down" periods as part of our ethical peer-to-peer network. By enabling Long-Session Peers, you ensure that you will be routed through peers who are known to stay active for extended periods of time, and can maintain a single IP address for a much longer period of time in comparison to regular Residential peers.

Benefits of Long-Session Peers

Consistent scraping operations: This stability minimizes disruptions caused by IP changes and maximizes the efficiency of your scraping tasks. You can rely on a consistent IP address for an extended period, allowing for long-duration scraping operations. This feature is particularly useful for projects that require continuous data extraction or monitoring.

Target specific OS

Bright Data allows targeting the following Operating Systems:

  • Windows:
    curl --proxy --proxy-user brd-customer-<USERNAME>-zone-<ZONE>-os-windows:<PASSWORD> "<TARGET SITE>"
  • MAC:
    curl --proxy --proxy-user brd-customer-<USERNAME>-zone-<ZONE>-os-osx:<PASSWORD> "<TARGET SITE>"
  • Android:
    curl --proxy --proxy-user brd-customer-<USERNAME>-zone-<ZONE>-os-android:<PASSWORD> "<TARGET SITE>"

Browse Chinese sites by using Chinese Residentials IPs

When outside of China 
Targeting Chinese Residential IP peers is enough.
For example:

curl --proxy --proxy-user brd-customer-<USERNAME>-zone-<ZONE>-country-cn:<PASSWORD> "<TARGET SITE>"

When inside China
In addition to Targeting Chinese Residentials IP peers, targeting our Chinese super-proxy is also required.

  • When using API commands, the proxy DNS server is
    For example:
    curl --proxy --proxy-user brd-customer-<USERNAME>-zone-<ZONE>-country-cn:<PASSWORD> "<TARGET SITE>"
  • When using the Proxy Manager:
    • Select relevant Port settings by simply clicking on the port  
    • Select Targeting and set China as the country
    • Select IP control: set Super Proxy location to "China".

Use a specific IP 

When using Bright Data's Residential Proxy network, you may find the need to use a specific IP allocated to your zone.

  1. Send a test request with a '--verbose' or '-v' option added (this will turn on verbose logging)
curl --verbose --proxy --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>:<ZONE_PASSWORD> ""
  1. Locate the x-brd-ip response header and copy its value

  1. Add the -ip- flag to your request, after your zone’s name and use the hashed IP value copied in the previous step
  1. Send a test request, and review the response
curl --proxy --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>-ip-<HASHED_IP>:<ZONE_PASSWORD> ""

We recommend using as the target domain for testing, and to review your IP credentials.

Was this article helpful?