Find answers to common questions about integrating, configuring, and using Bright Data’s Datacenter proxy products, including IP types, geotargeting, and error codes.
What are IP Types for Datacenter?
There are four types of IPs that we offer within our Datacenter Proxy Network:
What are IP Types for ISP?
There are three types of IPs that we offer within our ISP Proxy Network:
How to integrate a new proxy into your code?
To integrate the proxies into your code, please visit the API examples page, which can be accessed via your zone’s settings, under “access parameters”:
On this page, you can choose integration examples for most modern coding languages, just choose the integration type, your proxy zone, coding language, etc. and the page will generate a code snippet you can use right away.
How to integrate a proxy into 3rd party software?
Check out a few examples in the API examples page mentioned above (just choose “other software” in the “language” drop-down menu), or check our Integrations page, where we have specific guides to integrate our proxies within the most popular tools across the industry today.
Important note: If you are using Bright Data’s Web Unlocker API, Residential Proxies or the SERP API you probably need to use our SSL certificate to enable end-to-end secure connections. See instructions here.
How to target a Specific Country?
When sending your request, add the \-country
flag, after your zone’s name in the request, followed by the 2-letter ISO code for that country.
In the example below: We added \-country-us
to our request, so we will send a request originating from the United States (“us”).
How to target a Specific City in datacenter and ISP proxy networks?
For datacenter and ISP networks city targeting has deprecated.
Where does Bright Data have proxies?
Bright Data offers proxies in every country in the world, except in the following countries:
If you need proxies from there countries, unfortunately Bright Data will not be able to help you.
How to view the proxy event log?
The event log will show you (at most) the last 200 requests you made with any zone in your account.
In your Bright Data control panel’s proxies page: https://brightdata.com/cp/zones
Go to the “Event Log” tab:
The presented data is:
How to enable automatic IP fallbacks? (formerly 100% uptime)
Applicable for Datacenter & ISP
The Automatic Failover was built to prevent any ‘external’ events from affecting the user. The idea is simple and works the same way for both problems described above – if our system detects a problem, like a connectivity issue or an IP where the GEO isn’t exactly what you asked for when buying that IP, we will automatically route your requests through other IPs which are exactly the same as the original IPs.
At the same time, we wanted to make sure that customers that must use specific IPs will not be affected – so we made some exceptions:
The Automatic Failover brings immediate value by providing 100% connectivity and continuous high-performance level, free of charge and without having to make any changes in your code or how you work.
Automatic Failover feature can be turned on or off, via API.
How to enable Automatic Failover for proxies?
Navigate to your proxy configuration settings, and under Advanced settings enable ‘Automatic failover’
How to keep using the same IP in multiple requests?
Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread’s connection.
glob\_
as a prefix to your session:Full request example:
Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread’s connection.
How to see supported Ports & Protocols?
Ports 80 and 443 are available by default in all zones, supporting HTTP and HTTPS protocols.
In zones of proxies of type Datacenter or ISP, all ports higher than 1024 are supported by default.
In zones of proxies of type Residential or Mobile, the following ports wills be available by default: 8080, 8443, 5678, 1962, 2000, 4443, 4433, 4430, 4444 and 1969.
Bright Data can support additional ports by request. Every request to support a new port will be followed by a dedicated and additional compliance process with the Bright Data compliance team.
Examples of ports that require Bright Data compliance review before activation:
Port | Protocol |
---|---|
8443 | HTTP |
8243 | HTTPS |
To make a request to add a port permission to your zone:
How to target specific OS?
Bright Data allows targeting the following Operating Systems:
How to refresh IPs Allocated to Your Zone?
If you’ve selected ‘Pay per IP’ shared, or a dedicated IP type in your zone configuration, you’ll be allocated a fixed IP address. From time to time, depending on your use case, you may need to refresh these IP addresses.
In order to refresh IPs allocated to your zone, navigate to your selected zone, under ‘Allocated IPs’ click on ‘Show allocated IPs’, check the box of the IP or gIP you wish to refresh and click ‘Refresh’
Refreshing an IP or gIP will result in an extra charge.
Alternatively, you can use API to refresh your dedicated Residential IPs or your Datacenter/ISP IPs
How to 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.
We recommend using https://lumtest.com/myip.json as the target domain for testing, and to review your IP credentials.
How to target 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:
Note: Values for ASN number can be found here.
How to Target 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:
How to browse Chinese sites by using Chinese Residentials IPs
When outside of China
Targeting Chinese Residential IP peers is enough:
Carrier-specific Proxy peer IP
About geolocation databases, and how to check the proxy IP information?
Geolocation databases (GeoDB) are used by internet websites to query information about the IP address used by the users. Bright Data monitors and maintains correct records of the 4 main GeoDBs used today: Maxmind, ip2location, db-ip and Google.
There are many other smaller GeoDBs, most of which are using outdated records or flawed testing methods, and so the information they present is not accurate or is presented to lure their viewers to buy VPN or proxy products from them. Therefore, we highly recommend using the GeoDBs mentioned above when testing your IPs.
In order to see our information about the proxy IP that you are using, browse one of the following:
Which Bright Data products are best for scraping search engines (SERPs)?
SERP API is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more.
Browser API is the ideal product as it is our fully cloud-hosted browser designed to help you easily focus on your multi-step data collection while we take care of the full proxy and unblocking infrastructure for you, including CAPTCHA solving.
Can I target Google SERPs from the Residential, Datacenter, or ISP Proxy network?
Residential Proxy - No, SERP API is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more. Targeting Google SERPs from the Residential network will result in Super-proxy bypass, which will casue the request to be sent from our servers instead of the peer.
Datacenter & ISP Proxies - No. When attempting to specifically target Google through either of these proxy networks, your request will be denied and you will receive the following error message in the response headers:
Can I Send requests to IPs and not domain name?
No - requests directly to the host server, and not to the domain name are forbidden while using Bright data.
Requests using URL format such as 1.1.1.1:443 will be executed using the super proxy server, not the proxy peer IP.
Example of a request using the super proxy:
Can I use port 25 or any other SMTP port, or send an email by using the proxy IP?
Since BrightData cares about our community and peers quality, SMTP requests which can be used for spamming are blocked. Please note that mail domains are also blocked from access, and requests to mail domains will be sent from the super proxy server, and not the peer IP.
What is the cost for refreshing Datacenter IPs?
Refreshing data-center IPs will have a different cost depending on the type of IP.
Does Bright Data support the Socks5 protocol?
Yes. Bright data supports SOCKS5
protocol, with a default port 22228 assigned for SOCKS5 communication.
See here for full SOCKS5 configuration instructions
How do I control from where the request is performed?
brd-customer-<customer_id>-zone-<zone_name>-direct
How do I refresh session (IP)?
Using the same IP for a long period of time makes it easier for the target website to mark the IP as proxy and can make your request get detectable by the target website. Refreshing your IPs will result in allocation of new IPs from Bright Data instead of your existing ones in your pool allowing you to gain control over your pool and reach higher success rates.
Can I order missing proxies for datacenter and ISP?
Yes! Bright Data allows placing orders for Datacenter and ISP proxies in specific country for selected customers only, for at least 100 proxies. To see if your account is qualified to place IP orders browse here: https://brightdata.com/cp/zones/order_ips
If during zone save you get a message that proxies are not available in a specific country, try to select more countries or change your country setting to allow us to find proxies for you.
Once your request for missing proxies is placed, our team will attempt to provision the proxies. The acquiring and provisiong process usually takes up to 14 days. Once the proxies are ready, we will notify you. We encourage you to check again once every 2-3 days to see if inventory has refreshed and more proxies are available.
How can I move proxies (IPs) from zone to zone?
Moving prepaid datacenter or ISP unlimited proxies (shared and dedicated) from zone to zone is not yet supported via our control panel. It is in our plans to support moving proxies from zone to zone via self service. If you need proxies to be moved please contact our support team.
Find answers to common questions about integrating, configuring, and using Bright Data’s Datacenter proxy products, including IP types, geotargeting, and error codes.
What are IP Types for Datacenter?
There are four types of IPs that we offer within our Datacenter Proxy Network:
What are IP Types for ISP?
There are three types of IPs that we offer within our ISP Proxy Network:
How to integrate a new proxy into your code?
To integrate the proxies into your code, please visit the API examples page, which can be accessed via your zone’s settings, under “access parameters”:
On this page, you can choose integration examples for most modern coding languages, just choose the integration type, your proxy zone, coding language, etc. and the page will generate a code snippet you can use right away.
How to integrate a proxy into 3rd party software?
Check out a few examples in the API examples page mentioned above (just choose “other software” in the “language” drop-down menu), or check our Integrations page, where we have specific guides to integrate our proxies within the most popular tools across the industry today.
Important note: If you are using Bright Data’s Web Unlocker API, Residential Proxies or the SERP API you probably need to use our SSL certificate to enable end-to-end secure connections. See instructions here.
How to target a Specific Country?
When sending your request, add the \-country
flag, after your zone’s name in the request, followed by the 2-letter ISO code for that country.
In the example below: We added \-country-us
to our request, so we will send a request originating from the United States (“us”).
How to target a Specific City in datacenter and ISP proxy networks?
For datacenter and ISP networks city targeting has deprecated.
Where does Bright Data have proxies?
Bright Data offers proxies in every country in the world, except in the following countries:
If you need proxies from there countries, unfortunately Bright Data will not be able to help you.
How to view the proxy event log?
The event log will show you (at most) the last 200 requests you made with any zone in your account.
In your Bright Data control panel’s proxies page: https://brightdata.com/cp/zones
Go to the “Event Log” tab:
The presented data is:
How to enable automatic IP fallbacks? (formerly 100% uptime)
Applicable for Datacenter & ISP
The Automatic Failover was built to prevent any ‘external’ events from affecting the user. The idea is simple and works the same way for both problems described above – if our system detects a problem, like a connectivity issue or an IP where the GEO isn’t exactly what you asked for when buying that IP, we will automatically route your requests through other IPs which are exactly the same as the original IPs.
At the same time, we wanted to make sure that customers that must use specific IPs will not be affected – so we made some exceptions:
The Automatic Failover brings immediate value by providing 100% connectivity and continuous high-performance level, free of charge and without having to make any changes in your code or how you work.
Automatic Failover feature can be turned on or off, via API.
How to enable Automatic Failover for proxies?
Navigate to your proxy configuration settings, and under Advanced settings enable ‘Automatic failover’
How to keep using the same IP in multiple requests?
Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread’s connection.
glob\_
as a prefix to your session:Full request example:
Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread’s connection.
How to see supported Ports & Protocols?
Ports 80 and 443 are available by default in all zones, supporting HTTP and HTTPS protocols.
In zones of proxies of type Datacenter or ISP, all ports higher than 1024 are supported by default.
In zones of proxies of type Residential or Mobile, the following ports wills be available by default: 8080, 8443, 5678, 1962, 2000, 4443, 4433, 4430, 4444 and 1969.
Bright Data can support additional ports by request. Every request to support a new port will be followed by a dedicated and additional compliance process with the Bright Data compliance team.
Examples of ports that require Bright Data compliance review before activation:
Port | Protocol |
---|---|
8443 | HTTP |
8243 | HTTPS |
To make a request to add a port permission to your zone:
How to target specific OS?
Bright Data allows targeting the following Operating Systems:
How to refresh IPs Allocated to Your Zone?
If you’ve selected ‘Pay per IP’ shared, or a dedicated IP type in your zone configuration, you’ll be allocated a fixed IP address. From time to time, depending on your use case, you may need to refresh these IP addresses.
In order to refresh IPs allocated to your zone, navigate to your selected zone, under ‘Allocated IPs’ click on ‘Show allocated IPs’, check the box of the IP or gIP you wish to refresh and click ‘Refresh’
Refreshing an IP or gIP will result in an extra charge.
Alternatively, you can use API to refresh your dedicated Residential IPs or your Datacenter/ISP IPs
How to 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.
We recommend using https://lumtest.com/myip.json as the target domain for testing, and to review your IP credentials.
How to target 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:
Note: Values for ASN number can be found here.
How to Target 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:
How to browse Chinese sites by using Chinese Residentials IPs
When outside of China
Targeting Chinese Residential IP peers is enough:
Carrier-specific Proxy peer IP
About geolocation databases, and how to check the proxy IP information?
Geolocation databases (GeoDB) are used by internet websites to query information about the IP address used by the users. Bright Data monitors and maintains correct records of the 4 main GeoDBs used today: Maxmind, ip2location, db-ip and Google.
There are many other smaller GeoDBs, most of which are using outdated records or flawed testing methods, and so the information they present is not accurate or is presented to lure their viewers to buy VPN or proxy products from them. Therefore, we highly recommend using the GeoDBs mentioned above when testing your IPs.
In order to see our information about the proxy IP that you are using, browse one of the following:
Which Bright Data products are best for scraping search engines (SERPs)?
SERP API is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more.
Browser API is the ideal product as it is our fully cloud-hosted browser designed to help you easily focus on your multi-step data collection while we take care of the full proxy and unblocking infrastructure for you, including CAPTCHA solving.
Can I target Google SERPs from the Residential, Datacenter, or ISP Proxy network?
Residential Proxy - No, SERP API is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more. Targeting Google SERPs from the Residential network will result in Super-proxy bypass, which will casue the request to be sent from our servers instead of the peer.
Datacenter & ISP Proxies - No. When attempting to specifically target Google through either of these proxy networks, your request will be denied and you will receive the following error message in the response headers:
Can I Send requests to IPs and not domain name?
No - requests directly to the host server, and not to the domain name are forbidden while using Bright data.
Requests using URL format such as 1.1.1.1:443 will be executed using the super proxy server, not the proxy peer IP.
Example of a request using the super proxy:
Can I use port 25 or any other SMTP port, or send an email by using the proxy IP?
Since BrightData cares about our community and peers quality, SMTP requests which can be used for spamming are blocked. Please note that mail domains are also blocked from access, and requests to mail domains will be sent from the super proxy server, and not the peer IP.
What is the cost for refreshing Datacenter IPs?
Refreshing data-center IPs will have a different cost depending on the type of IP.
Does Bright Data support the Socks5 protocol?
Yes. Bright data supports SOCKS5
protocol, with a default port 22228 assigned for SOCKS5 communication.
See here for full SOCKS5 configuration instructions
How do I control from where the request is performed?
brd-customer-<customer_id>-zone-<zone_name>-direct
How do I refresh session (IP)?
Using the same IP for a long period of time makes it easier for the target website to mark the IP as proxy and can make your request get detectable by the target website. Refreshing your IPs will result in allocation of new IPs from Bright Data instead of your existing ones in your pool allowing you to gain control over your pool and reach higher success rates.
Can I order missing proxies for datacenter and ISP?
Yes! Bright Data allows placing orders for Datacenter and ISP proxies in specific country for selected customers only, for at least 100 proxies. To see if your account is qualified to place IP orders browse here: https://brightdata.com/cp/zones/order_ips
If during zone save you get a message that proxies are not available in a specific country, try to select more countries or change your country setting to allow us to find proxies for you.
Once your request for missing proxies is placed, our team will attempt to provision the proxies. The acquiring and provisiong process usually takes up to 14 days. Once the proxies are ready, we will notify you. We encourage you to check again once every 2-3 days to see if inventory has refreshed and more proxies are available.
How can I move proxies (IPs) from zone to zone?
Moving prepaid datacenter or ISP unlimited proxies (shared and dedicated) from zone to zone is not yet supported via our control panel. It is in our plans to support moving proxies from zone to zone via self service. If you need proxies to be moved please contact our support team.