Find answers to common questions about integrating, configuring, and using Bright Data’s proxy products, including IP types, geotargeting, and error codes.
What exactly is a zone and how important is the zone name?
brd-customer-<customer_id>-zone-<zone_name>-country-us
As mentioned, you cannot change the name of the zone after you have saved it - if you want to change the name, simply create a new with a new name.Integration with 3rd party tools
What are IP Types for Residential and Mobile Proxy?
What is a super-proxy?
-route_err-block
flag to your proxy username:What are the proxy (IP) Types for Datacenter?
What are IP Types for ISP?
How to find and rotate thru my allocated IPs?
host:port:username:password
format.-ip
or -gip
options. Read more about it here: Controlling your proxies. For advanced proxy rotation control you will need to install and route your requests using Bright Data proxy manager.How to integrate a new proxy into your code?
How can I test if my proxy is working?
How to integrate a proxy into 3rd party software?
How do I configure proxy in a specific country or location?
-country
flag, after your zone’s name in the request, followed by the 2-letter ISO code for that country.If you use a third-party tool or application, simply use the username that includes the country-xx
in the configuration. In other words, in the box where you need to put in the proxy username, enter the full string, including the country parameter, for example: brd-customer-<customer_id>-zone-<zone_name>-country-us
- don’t forget to use your own credentials that you can find in the “Overview” tab.If you use your own code, see the example below: We added -country-us
to our request, so we will send a request originating from the United States (“us”).How can I set default countries for zones with fixed IP pools?
-country-xx
flag to your request and override the default country selection.Why can't I find a country in the list?
How to target the EU region
How to target all countries except China?
How to target a Specific City?
Where does Bright Data have proxies?
How to view the proxy event log?
How to enable automatic IP fallbacks? (formerly 100% uptime)
How to enable Automatic Failover for proxies?
How to keep using the same IP in multiple requests?
glob_
as a prefix to your session:Where do I find is my proxy address and port?
How to allowlist/denylist IPs and domains?
How to see supported Ports & Protocols?
HTTP
& HTTPS
are supported by default.SOCKS5
protocol, with a default port 22228 assigned for SOCKS5 communication.SOCKS5 is supported for all Bright Data’s proxy networks: Datacenter, ISP, Residential, and Mobile.See here for full SOCKS5 configuration instructionsHow to target specific OS?
How to refresh IPs Allocated to Your Zone?
How to use a specific IP?
How to targeting an ASN specific IP?
How to Target Residential IP groups (gIPs)?
How to review usage stats for proxy products in the control panel
How to browse Chinese sites by using Chinese Residentials IPs
Carrier-specific Proxy peer IP
About geolocation databases, and how to check the proxy IP information?
Which Bright Data products are best for scraping search engines (SERPs)?
Can I target Google SERPs from the Residential, Datacenter, or ISP Proxy network?
Residential & Mobile networks
Can I Send requests to IPs and not domain name?
Can I use port 25 or any other SMTP port, or send an email by using the proxy IP?
Does Bright Data support the Socks5 protocol
SOCKS5
protocol, with a default port 22228 assigned for SOCKS5 communication.See here for full SOCKS5 configuration instructions or visit the SOCKS5 proxies page.How do I control from where the request is performed?
brd-customer-<customer_id>-zone-<zone_name>-direct
How do I refresh session (IP)?
How to browse Chinese sites by using Chinese residential IPs?
country-cn
flag in your credentialsHow to use the same IP for an extended period of time and how long can I keep it? (long session)
-ip
flag: View your proxy list in your zone’s pool (can be found in the control panel in the zone’s ‘overview’ tab) choose one IP and target it using the -ip
flag. This will route all your requests to the same IP. You can use the same IP as long as it is allocated to your zone.-session-<SESSION_ID>
flag your requests will be routed to the same IP. To make sure that the same IP is kept bound to your session ID, you need to ensure that the session is not kept idle for more than . You can have multiple parallel sessions at the same time - each one with a different IP allocated to it.What is Error code 502?
What is Error code 403?
Why am I getting SSL errors? (ERR_CERT_AUTHORITY_INVALID)
How do I redirect `curl` ourput to a file?
curl
output, you may want to redirect the output to a file. In order to do so add --output [filename]
to your curl
command options.How can I allow/block targeting specific domains in my zone?
How do I target government websites?
Why am I getting errors about robots.txt?
Do you offer IPv6 Proxies and how do I get IPv6 proxies?
How to understand why I am getting a certain error?
-v
or -verbose
flag to the request (for cURL), this will ensure you receive the response headers which contain important information regarding the source of the error and will guide you to a solution.If the response headers include x-brd-
then the error originates with BrightData and you should check the BrightData Error Catalog for further adviceOtherwise, there has not been a failure on our side - and you should instead check the article regarding Website BlockingIt could also be that the error originates from issues with your integration, you should check if you’ve integrated correctly, for help with integration - please see our Integrations SectionDoes Bright Data have any request limits?
Why cant I access (blocked) google, bing.com, youtube.com with proxies?
Why am i getting wrong geolocation when checking proxy IP?
How can I use Bright Data proxies in IP:PORT format?
IP/HOST:PORT:USERNAME:PASSWORD
.
If your integration method does not support this format and requires IP:PORT
only, you can use Bright Data Proxy Manager—a free, open-source tool that allows you to route requests to our proxies using the IP:PORT
format.For more details on configuring Proxy Manager for this setup, refer to our guide:
Port Targeting ConfigurationWhy has my IP address been added to the zone denylist?
ip_forbidden
error message.How to get your Bright Data connection information?
PROXY ERROR
in your toolDoes Bright Data proxies support HTTP3?
What should I know to work with HTTP3 with Bright Data proxy network?
curl
request checking the response header for alt-svc
header. If this header exists in the response it means the domain is offering access over HTTP3.curl
to query over HTTP3?curl
utility which is supporting HTTP3
. Most popular released of curl
does not support HTTP3
.protocol
column, if you see h3
it means requests are sent and received over HTTP3.