How to Configure Your Residential Proxy
Configure your Bright Data Residential Proxy settings with ease. Learn how to set IP types, enable geolocation targeting, manage advanced options like long-session peers, and more.
Start by going to the configuration tab of the proxy you want to configure.
IP type
Choose one of two IP types for your proxy zone:
Shared
When you want a cost-efficient option, and you don’t require IP exclusivity. These proxies will rotate, so in every request you can get a new IP address (“Rotating proxies”).
Dedicated IP
When you need to access websites with an exclusive IP address.
Geolocation targeting
Since your IPs are automatically allocated, it is recommended to set up a separate Residential proxy, for each geolocation you wish to target.
Geolocation targeting allows you to target specific locations based on City, State, Zip code, or ASN, but you need to configure the resolutions you want in your Zone before sending the request.
Select the needed parameter from the drop-down menu.
IP Groups gIPs
Only works with the Dedicated option
gIP contains between 6-90 IPs at any given moment while sharing the same attributes, targeting the selected dedicated domains within the zone “Configuration” section. gIPs are used by Bright Data to create a single identifier for this group of proxies (with distinct IP addresses). Those proxies will be used explicitly by you towards the domains you target.
Domains
Only works with the Dedicated option
Define the domains you’d like your proxies to be exclusive to. Every request to a domain in this list is served thru your dedicated proxies exclusively. No one else is allowed to target those domains via your dedicated proxies. You can use this zone for requests to other target domains, yet those requests will be served thru our datacenter hosted Bright Data proxies.
For example: if in the list you have two domains: a.com and b.com, every request to a.com and b.com are routed thru your dedicated proxies, request to c.com is routed thru our datacenter hosted proxy. Requests to a.com and b.com from others will never go thru your dedicated proxies.
Cache proxy
Bright Data’s cache proxy is a feature that aims to reduce the unneeded load from target sites by allowing customers to have their successful results cached on the one hand and, on the other hand, to receive cached results to their requests when possible.
Enable Cache Proxy
Simply toggle the cache proxy switch
Once switched on, we will walk you through some instructions required for the cache proxy to work.
You have two options to select from:
robots.txt in Cache Proxy
-
To align with our commitment to respectful and compliant web resource usage, our Cache Proxy feature adheres to
robots.txtdirectives, applying its logic across our different proxy networks. Upon opting into Cache Proxy within their chosen network, the operational behavior adjusts based onrobots.txtcompliance and the user’s KYC status:When an endpoint is accessible according torobots.txt, the service operates normally within the user’s selected proxy network, whether that’s Residential, Mobile, Datacenter or ISP. -
If an endpoint is blocked by
robots.txtrules, or the request type is one ofPOST,PUT,PATCH, orDELETE, the handling of the request is contingent on the network type and user verification:-
For users on the Residential and Mobile networks, those who have undergone Know Your Customer (KYC) verification will have their requests redirected through our super proxy for direct processing. Unverified users will see their requests blocked.
-
For users on the data center and ISP networks, such requests will be blocked regardless of KYC status.
-
Advanced options:
Enable JavaScript rendering with hosted Browsers
By enabling JavaScript rendering with hosted browsers, your proxy requests will also run through Bright Data’s dedicated and fully hosted Chromium-based scraping browsers. This way, your dynamic scraping using Puppeteer, Playwright, or Selenium can be easily scaled using cloud-based browsers, optimized for scraping using HTTP requests’ presets which allow faster CAPTCHA solving and real-time troubleshooting.
Enable Automated Unlocking
By enabling the Automated Unlocking feature, proxy requests will be sent via Bright Data proxy pre-set which automatically takes care of both your IP level management and HTTP request handling, increasing success rates and streamlining your scraping operations.
Ports
The following ports are open by default: 80, 443, 8080, 8443, 5678, 1962, 2000, 4443, 4433, 4430, 4444 and 1969.
If you need access to other ports, click “Add ports” and fill out the form. Bright Data’s compliance team will review the request and update you.
Long-session peers: Deprecated
Bright Data used to offer long session peers. This is no longer offerred, account which had zone configured with long session peers will still be able to use them.
Enable Long-session peers: Deprecated
Bright Data does not offer long session peers anymore.
Simply, go to an existing Mobile 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.
Was this page helpful?