Bright Data Docs home pagelight logodark logo
  • Support
  • Sign up
  • Sign up
Welcome
Proxy Infrastructure
Web Access APIs
Data Feeds
API Reference
General
Integrations
  • Account
  • Policy
  • Privacy
  • Security
  • Usage Monitor
  • Authentication
  • Cloud Providers
  • FAQs
  • How do I scrape site XYZ?
  • Webhook Notifications

FAQs

You can find your username and password for your Bright Data product (e.g. proxy, unlocker, Browser API etc) in the “Overview” tab for product you created. You can create more than one password if you want.

Note: the username and password you created for the Bright Data site are NOT used for accessing the actual products. It is only used for dashboard access.

​
Proxy port

When working with Bright Data proxies in Native mode, you need to provide a proxy port. This setting is redundant when working with proxy APIs - see more here of the differences between API vs. native Access.

​
Proxy port transition

Bright data now serving requests over native proxy port 33335. In the past, we served requests over port 22225 which is now phasing out. Bright data has updated its current SSL certificate which will expire in September, 2026 to a new certificate which will expire in September 2034.

For proxy zones of types Residential, Mobile, Unlocker and SERP which require either KYC or SSL Certificate it is essential to install the correct certificate which complies with port used.

If you are already using the old SSL certificate in your code or installed on your machine, we strongly rcommend plan the transition to new port 33335 at your earliest convenience.

​
Supported settings

PortCertificateExpiration
22225Old certificateSeptember 2026
33335New certificateSeptember 2034

​
Working in Tandem

As two certificates operate in tandem and differ by port, you can gracefully migrate your proxy and scraping tools to the new port and certificate. As long as you use the correct certificate towards the correct port (new -> 33335 and old -> 22225) it should work.

​
Transition steps

To transition from port 22225 to 33335 you should:

  1. Inform your network administrator or security administrator to open the domain brd.superproxy.io on port 33335 for outgoing communication.
  2. If you are using certificate: install the new certificate. See instructions on certificate installtion here: SSL Certificate

Even if you first signed in with ‘magic link’ or or using a six digit code, you can always create a password for your account. You can then save the password in your browser for faster access to the control panel.

To set up a password for your Bright Data account, follow these steps:

  1. Access authentication settings: Click on “Settings” and go to the ‘Passwords & authentication’ tab
  2. Create your password: Follow the instructions to create a password for your account. We recommend a least a 10-digit password with numbers and symbols.

Remember, each user must set their own password. If you have other users on your account, they can configure their passwords individually if needed.

Note: If you’re authenticated via third-party service like Google or GitHub, please add a separate user and sign in through Bright Data’s standard signup flow instead of using third-party services.

To review the list of IPs allocated to your zone, simply navigate to ‘My proxies page’, click on your Proxy zone, scroll down to the ‘Allocated IPs’ section, then simply click ‘Show allocated IPs’ or ‘Download IPs list’.

Due to privacy and security concerns, this option is not available for Residential Shared Pay-Per-GB configuration. See -session flag instead.

There are 2 ways to view your zones statistics:

  • To see stats across all your zones, go to your dashboard:

  • To see stats for a specific zone, click on “Proxies and Scraping” on the left navigation bar and go to the zone’s settings and click the “statistics” tab:

  • To see stats across all your zones, go to your dashboard:

  • To see stats for a specific zone, click on “Proxies and Scraping” on the left navigation bar and go to the zone’s settings and click the “statistics” tab:

  • Please visit this page to see all available API endpoints (in multiple languages) and example responses related to viewing statistics.

By default, all proxy zones have unlimited usage, and you can set a limit by one of 4 parameters:

  • $/day
  • $/month
  • bytes/day
  • bytes/month

To set this limit on one of your zones, from Bright Data’s ‘My proxies page’

1

Go to any of your zone's settings by clicking on that zone.

2

Go to the "Access parameters" tab.

3

Scroll down to "Limit", the default value is "unlimited"

4

Click the "edit" button

5

Enable the "spend limit" option.

6

Set the parameters you wish to work with and click "update"

7

You'll see the change back in the Limit section and the proxies page, in the Usage/Spend Limit column.

How did we calculate this table?

Your company needs to collect information from the web by sending 1,000 http requests per hour to a specific website. You write the scraper code and run it through a server. The target website allows 50 requests per minute from the same IP before blocking your scraper. Now, you have to purchase more proxies.

Assuming you choose datacenter proxies:
You don’t want to share IPs, so you buy 200 dedicated data-center IPs. You code the integration of the scraper with the new data-center proxies for 2 hours and then run the new program. This time, it takes 3 days for your target website to detect your scraper. Once your proxies are detected, you’ll have to purchase new proxies and repeat this process again, checking each day to make sure the proxies haven’t been detected. Cost per month (all numbers are from real customers):

  • 200 dedicated IPs: $500
  • Bandwidth: (1000 request X 20KB per request X 24 hours X 30 days = 14.5GB): $3 per month
  • Developer (2 hours integration X 10 + 1 hour every 3 days for managing the proxies): ~3 days of work a month or ~$900

Your total cost per month will be at least 1400forjustthesethingsalone,andthesalaryof1400 for just these things alone, and the salary of 1400forjustthesethingsalone,andthesalaryof

30 per hour for a developer is very conservative. Additionally, this doesn’t account for a lack of information reliability if your target website sends misinformation before blocking you or if your information flow is cut every few days, which can be detrimental to your brand or your revenue stream.

Assuming you choose Bright Data residential proxies:
You buy a basic package of 40GB with access to unlimited residential IPs. It takes 2 hours to integrate your scraper. Due to an average of 3 million residential IPs available each day, your target website can’t detect your scraper, allowing you to focus on other projects.

The bandwidth and unlimited IPs cost just 500permonth.Yourinformationisalwaysreliablebecauseyourrequestsarealwayssuccessfulandaccessisnevercutinthemiddleofthemonth.Whenyourbusinessgrowsasaresultofthisscrapingandyourprojectsexceed600MBeachmonth,thedifferenceincostscanbemuchhigherthanjust 500 per month. Your information is always reliable because your requests are always successful and access is never cut in the middle of the month. When your business grows as a result of this scraping and your projects exceed 600MB each month, the difference in costs can be much higher than just \\~500permonth.Yourinformationisalwaysreliablebecauseyourrequestsarealwayssuccessfulandaccessisnevercutinthemiddleofthemonth.Whenyourbusinessgrowsasaresultofthisscrapingandyourprojectsexceed600MBeachmonth,thedifferenceincostscanbemuchhigherthanjust 

Bright Data also allows you to suspend your account when not in use, so your cost can be lower than 500permonth.Startbyusingthe500 per month. Start by using the 500permonth.Startbyusingthe

5 voucher for free data-center traffic to test Bright Data’s benefits and then ask for access to our residential network for cheap and reliable data collection.

This is a reminder to setup your allowlist access

To restrict your proxy zone access from access from anauthorized servers, we recommend you setup an IP allowlist. This will ensure only IPs you recognize will be allowed to access your proxy zone, for higher security and control.

Consult your IT or networking specialist to make sure your outgoing IP is fixed and does not change, otherwise you may block yourself or other authorized users from your company to access the proxy zone.

This workflow is optimal when using multiple crawlers with rotating IPs that target the Proxy Manager installed remotely. This method requires you API key an Authentication token.

Run From inside the remote server the next command in Terminal/CMD

Copy
curl -X GET "http://127.0.0.1:22999/api/gen_token" -H "accept: application/json"

This will generate an API key as an authentication token for you:

Output
Copy
"token":"<API_KEY>"

Now you can simply send a request using the API key you just created:

Copy
curl -x token:<API_KEY>@<remote-server-IP>:<Port> "target-site.com"

Yes

You can check if your public data was collected here:https://brightdata.com/check\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\_your\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\_data.

We never collect private data. We only collect publicly-available data.

When you sign up, your account automatically enters a free trial “Playground mode” for the first 3 days, allowing you to instantly try different Bright Data solutions. No credit card or any other form of payment method is needed.

You can extend this free trial. To test or use Bright Data’s proxy solutions without any kind of limitations and receive a $5 free credit, verify your account to start our Limited 30 day trial. Note that the 30-day trial does not apply to certain countries.

Submitting a KYC verification form or a port request form is not available during Playground mode. To start the KYC or ports request process you will need to deposit at least $10 to your account.

Playground mode is a free trial intended for small-scale testing and exploration, not for large-scale tests or production use. Product usage is subject to limitations such as speed, bandwidth, and requests per second until you verify your account and start our Limited Trial.

Limited Trial mode if a free trial period that allows you to freely explore our Bright Data proxy solutions without immediate payment. You’ll receive a $5 credit to use any of our proxy services for a period of 30 days, giving you a full month to test and experience our offerings.

Note that the 30-day trial does not apply to certain countries. If you don’t see this option, add funds to your account to start using Bright Data - you can add as little as $10 to get started with a Pay as You Go plan.

​
How do I verify my account to start the “Limited Trial” and receive a $5 credit?

Account verification is simple and free. Just add a valid payment method to your account to start Limited Trial mode and receive your $5 credit. You will not be charged.

​
What happens after the 30-day trial?

At the end of the 30-day trial period, your free credits will expire (if not already used) and you will need to add funds to your account to continue using our platform.

​
Can I use the free credit on any of your proxy products?

Yes, the $5 trial credit can be used on any of our proxy products during the duration of the trial, allowing you to test the products that best fit your needs.

In rare cases, some ad-blocking program/extensions can block access to Bright Data sites. If you encounter any issues, allowlist brightdata.com or disable the ad-blocker.

Below is the list of ISO 3166 country codes. Not all the countries in the list have Bright Data proxies, most of the countries do.

Country NameCountry code
Åland Islandsax
Zimbabwezw
Zambiazm
Yemenye
Western Saharaeh
Wallis and Futunawf
Virgin Islands (U.S.)vi
Virgin Islands (British)vg
Viet Namvn
Venezuela (Bolivarian Republic of)ve
Vanuatuvu
Uzbekistanuz
Uruguayuy
United States of America (the)us
United States Minor Outlying Islands (the)um
United Kingdom of Great Britain and Northern Ireland (the)gb
United Arab Emirates (the)ae
Ukraineua
Ugandaug
Tuvalutv
Turks and Caicos Islands (the)tc
Turkmenistantm
Turkeytr
Tunisiatn
Trinidad and Tobagott
Tongato
Tokelautk
Togotg
Timor-Lestetl
Thailandth
Tanzania, United Republic oftz
Tajikistantj
Taiwan (Province of China)tw
Syrian Arab Republicsy
Switzerlandch
Swedense
Svalbard and Jan Mayensj
Surinamesr
Sudan (the)sd
Sri Lankalk
Spaines
South Sudanss
South Georgia and the South Sandwich Islandsgs
South Africaza
Somaliaso
Solomon Islandssb
Sloveniasi
Slovakiask
Sint Maarten (Dutch part)sx
Singaporesg
Sierra Leonesl
Seychellessc
Serbiars
Senegalsn
Saudi Arabiasa
Sao Tome and Principest
San Marinosm
Samoaws
Saint Vincent and the Grenadinesvc
Saint Pierre and Miquelonpm
Saint Martin (French part)mf
Saint Lucialc
Saint Kitts and Neviskn
Saint Helena, Ascension and Tristan da Cunhash
Saint Barthélemybl
Réunionre
Rwandarw
Russian Federation (the)ru
Romaniaro
Republic of North Macedoniamk
Qatarqa
Puerto Ricopr
Portugalpt
Polandpl
Pitcairnpn
Philippines (the)ph
Perupe
Paraguaypy
Papua New Guineapg
Panamapa
Palestine, State ofps
Palaupw
Pakistanpk
Omanom
Norwayno
Northern Mariana Islands (the)mp
Norfolk Islandnf
Niuenu
Nigeriang
Niger (the)ne
Nicaraguani
New Zealandnz
New Caledonianc
Netherlands (the)nl
Nepalnp
Naurunr
Namibiana
Myanmarmm
Mozambiquemz
Moroccoma
Montserratms
Montenegrome
Mongoliamn
Monacomc
Moldova (the Republic of)md
Micronesia (Federated States of)fm
Mexicomx
Mayotteyt
Mauritiusmu
Mauritaniamr
Martiniquemq
Marshall Islands (the)mh
Maltamt
Maliml
Maldivesmv
Malaysiamy
Malawimw
Madagascarmg
Macaomo
Luxembourglu
Lithuanialt
Liechtensteinli
Libyaly
Liberialr
Lesothols
Lebanonlb
Latvialv
Lao People’s Democratic Republic (the)la
Kyrgyzstankg
Kuwaitkw
Korea (the Republic of)kr
Korea (the Democratic People’s Republic of)kp
Kiribatiki
Kenyake
Kazakhstankz
Jordanjo
Jerseyje
Japanjp
Jamaicajm
Italyit
Israelil
Isle of Manim
Irelandie
Iraqiq
Iran (Islamic Republic of)ir
Indonesiaid
Indiain
Icelandis
Hungaryhu
Hong Konghk
Hondurashn
Holy See (the)va
Heard Island and McDonald Islandshm
Haitiht
Guyanagy
Guinea-Bissaugw
Guineagn
Guernseygg
Guatemalagt
Guamgu
Guadeloupegp
Grenadagd
Greenlandgl
Greecegr
Gibraltargi
Ghanagh
Germanyde
Georgiage
Gambia (the)gm
Gabonga
French Southern Territories (the)tf
French Polynesiapf
French Guianagf
Francefr
Finlandfi
Fijifj
Faroe Islands (the)fo
Falkland Islands (the) [Malvinas]fk
Ethiopiaet
Eswatinisz
Estoniaee
Eritreaer
Equatorial Guineagq
El Salvadorsv
Egypteg
Ecuadorec
Dominican Republic (the)do
Dominicadm
Djiboutidj
Denmarkdk
Côte d’Ivoireci
Czechiacz
Cypruscy
Curaçaocw
Cubacu
Croatiahr
Costa Ricacr
Cook Islands (the)ck
Congo (the)cg
Congo (the Democratic Republic of the)cd
Comoros (the)km
Colombiaco
Cocos (Keeling) Islands (the)cc
Christmas Islandcx
Chinacn
Chilecl
Chadtd
Central African Republic (the)cf
Cayman Islands (the)ky
Canadaca
Camerooncm
Cambodiakh
Cabo Verdecv
Burundibi
Burkina Fasobf
Bulgariabg
Brunei Darussalambn
British Indian Ocean Territory (the)io
Brazilbr
Bouvet Islandbv
Botswanabw
Bosnia and Herzegovinaba
Bonaire, Sint Eustatius and Sababq
Bolivia (Plurinational State of)bo
Bhutanbt
Bermudabm
Beninbj
Belizebz
Belgiumbe
Belarusby
Barbadosbb
Bangladeshbd
Bahrainbh
Bahamas (the)bs
Azerbaijanaz
Austriaat
Australiaau
Arubaaw
Armeniaam
Argentinaar
Antigua and Barbudaag
Antarcticaaq
Anguillaai
Angolaao
Andorraad
American Samoaas
Algeriadz
Albaniaal
Afghanistanaf

Not really. Bright data is a service for enterprise customers who want to collect public web data from the Internet, and is not designed for private users.

In addition, using Bright data does not encrypt your Internet traffic.

If you want a free VPN, we recommend you check out BrightVPN - it is available for Windows and macOS, and does not even require you to open an account, ensuring complete anonymity.

Yes, we he an extensive coverage of actions that can be performed programatically via code by using our direct API to manage your account and proxies/zones - you can perform actions like adding or deleting zones, managing IP allowlists/denylists, fetch a list of IPs allocated to your zone, get billing balance and so on. For more detailed and accurate information, please see or API documentation section - Account Managment API Documentation

You can add your company details in the Account Settings, and your monthly invoices will be addressed to your company automatically.

You cannot directly “change” or “update” the email adress in your account. But, you can create a new user with the new email adress, and then delete the “old” user - this would achieve the same desired result as updating/changing/replacing your email adress.

To gain access your proxies by IP allowlist authentication only (IP:PORT), without using the API key authentication method or the USERNAME:PASSWORD authentication method, you can utilize the Proxy Manager tool.

You account verification status is under account settings -> Profile in Bright Data control panel. In there you can see your verification sttus

No, only company email addresses are accepted for KYC verification.

To see our legal restrictions and policies, please see the following page: Bright Data Master Service Agreement

If you need to reach out to our staff, you can do that either through the Help & Support section in the control panel - in the top right section of the screen under the question mark icon (?) or by emailing sales@brightdata.com, support@brightdata.com or compliance@brightdata.com

Note: assistance from our staff is only provided to paying customers or customers who are employees of an enterprise. If the option to contact support is not available via the control panel, please add funds to your account and the option will be unlocked.

zproxy.lum-superproxy.io is a deprecated proxy integration endpoint that was used by BrightData in the past - It should not be used anymore as it has been replaced with: brd.superproxy.io

**When should I use scrapers vs. datasets?**

  • Use Scrapers: When you need fresh or real-time data (e.g., prices, news, or live updates) or if the data isn’t available in existing datasets. Scrapers are ideal for tracking changes over time or gathering niche, specific information directly from websites.
  • Use Datasets: When you need historical data or pre-collected, and structured information. Datasets save time and effort, especially for machine learning, analytics, or research, but may not always be up-to-date.

For ongoing projects, you can combine datasets for historical context and scrapers for real-time updates.

If you wish to completely delete your account:

  • Go to Settings -> Account Settings -> Profile.
  • Click on Delete account

Notice that:

  • This action cannot be undone.
  • All your data and settings will be lost
  • All users will be logged out and lose access to the platform

Your Bright Data account ID is a component in your proxy username credentials, and when asking for support, you may need to provide it so supper engineer can provide propper answer.

Your account ID and login to Bright Data control panel **are not **your proxy logins. Each zone has its own username and password to access.

You can see your bright data account ID if you click the User icon on the top right part of your control panel, or by browsing to : “Account settings” on the left menu and selecting the “Profile” tab. You can access the profile tab directly by using this link: https://brightdata.com/cp/setting/customer_details

In order to submit a KYC you must register to BrightData.com with a **company email . **Free emails like ***@google.com or ***@yahoo.com com are not eligible to submit a KYC. Requests from free email providers are not allowed and rejected on the spot.

During the process, you wll be required to provide proof of identity, business identity and ownership/role as well as your business use cases.

Was this page helpful?

SnowflakeHow do I scrape site XYZ?
linkedinyoutubegithub
Powered by Mintlify
Assistant
Responses are generated using AI and may contain mistakes.