How to Configure Your Residential Proxy

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:

---

​

Geolocation targeting

Geolocation targeting allows you to target specific locations based on City, State, Zip code, or ASN. Select the needed parameter from the drop-down menu.

---

​

IP Groups gIPs

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.

---

​

Domains

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.txt directives, applying its logic across our different proxy networks. Upon opting into Cache Proxy within their chosen network, the operational behavior adjusts based on robots.txt compliance and the user’s KYC status:

  When an endpoint is accessible according to robots.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.txt rules, or the request type is one of POST, PUT, PATCH, or DELETE, 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

Long-Session Peers enable 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.

​

Enable Long-session peers: Deprecated

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.