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

• Integrate a new proxy into your code
• Integrate a proxy into a 3rd party software
• Target a Specific Country or City with Bright Data proxies
• Review IPs Allocated to Your Zone
• View the proxy event log
• Understand your zone's statistics
• 100% uptime - Assigning automatic IP fallbacks
• Keep using the same IP in multiple requests
• Set limits to bandwidth usage
• Whitelist/blacklist IPs and domains
• See supported ports & protocols
• Target a Specific OS
• Target countries in Europe
• Refresh IPs allocated to your zone

How to: Residential Proxy specific 

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

• Target an ASN specific Proxy IP
• Targeting Residential IP groups (GIPs)

• Browse Chinese sites with local Chinese Residential IPs

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 brd.superproxy.io:22225 --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 brd.superproxy.io:22225 --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 re 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 brd.superproxy.io:22225 --proxy-user brd-customer-<USERNAME>-zone-<ZONE>-os-windows:<PASSWORD> "<TARGET SITE>"

• MAC:

  curl --proxy brd.superproxy.io:22225 --proxy-user brd-customer-<USERNAME>-zone-<ZONE>-os-osx:<PASSWORD> "<TARGET SITE>"

• Android:

  curl --proxy brd.superproxy.io:22225 --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 brd.superproxy.io:22225 --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 servercountry-cn.brd.superproxy.io
  For example:

  curl --proxy servercountry-cn.brd.superproxy.io:22225 --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".