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 need 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”).
Proxies are shared across multiple users
Dedicated IP
When you need an exclusive access to a set of specific domains, with minimal to no rotation at all.
Proxies are used by you only towards the specified target domains.
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.
Shared pool default countries selection
When selecting countries in shared pool configuration, we will assign proxies only from the countries you select. You can select none (which meand we will assign the next random proxy from the pool), one or more countries. Read more…
To select a specific country for your peer during rotation, use the flag -country in the proxy user name parameter with an ISO-3166 country code.
FAQ: Where can I see the list of country codes?
Dedicated Residential proxies access
Our dedicated residential proxies are accessible only to customers who were verified by our compliance department (Full mode). Customers with “Immediate access” mode will see this option as disabled in our control panel. To read more about it visit: https://docs.brightdata.com/proxy-networks/residential/network-access.
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.
Advanced options:
Automatic Failover
In case we cannot reach the proxy peer for your request, we will route the request to another available peer. Automatic failover does not apply when you choose default countries: if we cannot find a peer in the country you selected, we will fail the request with error.
Enabling automatic failover assures execution of the request, regardless of the availability of a specific peer.
Special Ports & Protocols
Ports 80 and 443 are available by default, supporting HTTP and HTTPS & SOCKS5 protocols. We also support all ports over 1024 in our Datacenter proxy network. Read more on ports and protocols…
Zone usage limit
Set usage limit to your zone: you can limit spending or traffic. This provides additional layer of control to your budget and bandwidth consumption, mostly over our rotating shared pool proxies.
Long-session peers: Deprecated
Bright Data used to offer long session peers. This is no longer offered, account which had zone configured with long session peers will still be able to use them.
To see how to direct requests to explicit proxies, or create a sequence of requests with the same context (session) routed thru the same proxy peer see here: https://docs.brightdata.com/api-reference/proxy/rotate_ips#proxy-and-ip-rotation-control
Was this page helpful?