Bright Data
This page will guide you on how to generate sticky and rotating proxies, Supported countries, other optional features, White labeling and FAQs regarding Bright Data APIs.
How to generate Sticky Proxies:
const string = (length) => {
let result = '';
const characters = 'abcdefghijklmnopqrstuvwxyz1234567890';
const charactersLength = characters.length;
for (let i = 0; i < length; i++) {
result += characters.charAt(Math.floor(Math.random() * charactersLength));
}
return result;
};
function proxyGenerationSticky(amount, country, user_id, username, password) {
proxy = [];
for (var i = 0; i < parseInt(amount); i++) {
proxy.push(
`brd.x.proxiess.com:22225:${username}:${password}-country-${countryCode.toLowerCase()}-session-${string(
12,
)}\n`,
);
}
return proxy.join('');
}
Session ( add this under sticky proxy generation )
The -session- key instructs our routing system to either create or resolve a unique session for the connection. The value assigned to this key must be a random alphanumeric string, precisely 12 characters in length. This ensures the uniqueness and integrity of the session.
General Proxy format of Brightdata Sticky:
<Domain>:<Port>:<username>:<password>-country-<country code>-session-<session id>
Follow the below table for generate proxies .
Brightdata (Default)
HTTP/HTTPS
brd.x.proxiess.com
22225
Brightdata EU
HTTP/HTTPS
brdeu.x.proxiess.com
22226
Brightdata Asia
HTTP/HTTPS
brdasia.x.proxiess.com
22227
Brightdata (Default)
SOCKS5
socksbrd.x.proxiess.com
22228
Brightdata EU
SOCKS5
socksbrdeu.x.proxiess.com
22229
Brightdata Asia
SOCKS5
socksbrdasia.x.proxiess.com
22230
How to generate Rotating Proxies:
function proxyGenerationRotating(amount, country, username, password) {
proxy = [];
for (var i = 0; i < parseInt(amount); i++) {
proxy.push(
`brd.x.proxiess.com:22225:${username}:${password}-country-${country.toLowerCase()}\n`,
}
return proxy.join('');
}
General Proxy format of Brightdata Rotating:
<Domain>:<Port>:<username>:<password>-country-<country code>
Follow the below table for generate proxies.
Brightdata (Default)
HTTP/HTTPS
brd.x.proxiess.com
22225
Brightdata EU
HTTP/HTTPS
brdeu.x.proxiess.com
22226
Brightdata Asia
HTTP/HTTPS
brdasia.x.proxiess.com
22227
Brightdata (Default)
SOCKS5
socksbrd.x.proxiess.com
22228
Brightdata EU
SOCKS5
socksbrdeu.x.proxiess.com
22229
Brightdata Asia
SOCKS5
socksbrdasia.x.proxiess.com
22230
Supported countries:
Countries: [
{ name: 'GB', display: 'United Kingdom' },
{ name: 'SI', display: 'Slovenia' },
{ name: 'IT', display: 'Italy' },
{ name: 'FR', display: 'France' },
{ name: 'LV', display: 'Latvia' },
{ name: 'CZ', display: 'Czechia' },
{ name: 'PH', display: 'Philippines' },
{ name: 'MA', display: 'Morocco' },
{ name: 'UG', display: 'Uganda' },
{ name: 'RU', display: 'Russian Federation' },
{ name: 'TR', display: 'Turkey' },
{ name: 'TH', display: 'Thailand' },
{ name: 'BD', display: 'Bangladesh' },
{ name: 'ES', display: 'Spain' },
{ name: 'MT', display: 'Malta' },
{ name: 'GR', display: 'Greece' },
{ name: 'VN', display: 'Viet Nam' },
{ name: 'BF', display: 'Burkina Faso' },
{ name: 'US', display: 'United States' },
{ name: 'AL', display: 'Albania' },
{ name: 'DZ', display: 'Algeria' },
{ name: 'JP', display: 'Japan' },
{ name: 'KE', display: 'Kenya' },
{ name: 'HU', display: 'Hungary' },
{ name: 'RO', display: 'Romania' },
{ name: 'ID', display: 'Indonesia' },
{ name: 'NG', display: 'Nigeria' },
{ name: 'IN', display: 'India' },
{ name: 'AF', display: 'Afghanistan' },
{ name: 'CN', display: 'China' },
{ name: 'LK', display: 'Sri Lanka' },
{ name: 'CO', display: 'Colombia' },
{ name: 'MX', display: 'Mexico' },
{ name: 'RS', display: 'Serbia' },
{ name: 'DO', display: 'Dominican Republic' },
{ name: 'IE', display: 'Ireland' },
{ name: 'IR', display: 'Iran, Islamic Republic of' },
{ name: 'BR', display: 'Brazil' },
{ name: 'EG', display: 'Egypt' },
{ name: 'MV', display: 'Maldives' },
{ name: 'UA', display: 'Ukraine' },
{ name: 'CH', display: 'Switzerland' },
{ name: 'MH', display: 'Marshall Islands' },
{ name: 'PE', display: 'Peru' },
{ name: 'TZ', display: 'Tanzania, United Republic of' },
{ name: 'VE', display: 'Venezuela, Bolivarian Republic of' },
{ name: 'AR', display: 'Argentina' },
{ name: 'LY', display: 'Libya' },
{ name: 'TW', display: 'Taiwan, Province of China' },
{ name: 'HR', display: 'Croatia' },
{ name: 'SE', display: 'Sweden' },
{ name: 'BT', display: 'Bhutan' },
{ name: 'NO', display: 'Norway' },
{ name: 'PG', display: 'Papua New Guinea' },
{ name: 'PT', display: 'Portugal' },
{ name: 'YE', display: 'Yemen' },
{ name: 'FI', display: 'Finland' },
{ name: 'NP', display: 'Nepal' },
{ name: 'NZ', display: 'New Zealand' },
{ name: 'UY', display: 'Uruguay' },
{ name: 'AO', display: 'Angola' },
{ name: 'HN', display: 'Honduras' },
{ name: 'IQ', display: 'Iraq' },
{ name: 'NL', display: 'Netherlands' },
{ name: 'PY', display: 'Paraguay' },
{ name: 'SO', display: 'Somalia' },
{ name: 'CF', display: 'Central African Republic' },
{ name: 'SD', display: 'Sudan' },
{ name: 'BI', display: 'Burundi' },
{ name: 'DE', display: 'Germany' },
{ name: 'KR', display: 'Korea, Republic of' },
{ name: 'KZ', display: 'Kazakhstan' },
{ name: 'MY', display: 'Malaysia' },
{ name: 'PL', display: 'Poland' },
{ name: 'PS', display: 'Palestine, State of' },
{ name: 'CL', display: 'Chile' },
{ name: 'CU', display: 'Cuba' },
{ name: 'EE', display: 'Estonia' },
{ name: 'SN', display: 'Senegal' },
{ name: 'SV', display: 'El Salvador' },
{ name: 'SY', display: 'Syrian Arab Republic' },
{ name: 'UZ', display: 'Uzbekistan' },
{ name: 'BE', display: 'Belgium' },
{ name: 'CA', display: 'Canada' },
{ name: 'NA', display: 'Namibia' },
{ name: 'SA', display: 'Saudi Arabia' },
{ name: 'BJ', display: 'Benin' },
{ name: 'GE', display: 'Georgia' },
{ name: 'JO', display: 'Jordan' },
{ name: 'PA', display: 'Panama' },
{ name: 'AM', display: 'Armenia' },
{ name: 'BB', display: 'Barbados' },
{ name: 'CG', display: 'Congo' },
{ name: 'ET', display: 'Ethiopia' },
{ name: 'KP', display: "Korea, Democratic People's Republic of" },
{ name: 'MZ', display: 'Mozambique' },
{ name: 'WS', display: 'Samoa' },
{ name: 'DM', display: 'Dominica' },
{ name: 'LT', display: 'Lithuania' },
{ name: 'SB', display: 'Solomon Islands' },
{ name: 'SR', display: 'Suriname' },
{ name: 'SS', display: 'South Sudan' },
{ name: 'ZW', display: 'Zimbabwe' },
{ name: 'AT', display: 'Austria' },
{ name: 'BW', display: 'Botswana' },
{ name: 'GA', display: 'Gabon' },
{ name: 'IS', display: 'Iceland' },
{ name: 'OM', display: 'Oman' },
{ name: 'SM', display: 'San Marino' },
{ name: 'ZA', display: 'South Africa' },
{ name: 'ZM', display: 'Zambia' },
{ name: 'AG', display: 'Antigua and Barbuda' },
{ name: 'AU', display: 'Australia' },
{ name: 'KG', display: 'Kyrgyzstan' },
{ name: 'LB', display: 'Lebanon' },
{ name: 'PK', display: 'Pakistan' },
{ name: 'SK', display: 'Slovakia' },
{ name: 'AE', display: 'United Arab Emirates' },
{ name: 'BY', display: 'Belarus' },
{ name: 'CR', display: 'Costa Rica' },
{ name: 'QA', display: 'Qatar' },
{ name: 'BZ', display: 'Belize' },
{ name: 'CY', display: 'Cyprus' },
{ name: 'IL', display: 'Israel' },
{ name: 'KW', display: 'Kuwait' },
{ name: 'MG', display: 'Madagascar' },
{ name: 'TM', display: 'Turkmenistan' },
{ name: 'BH', display: 'Bahrain' },
{ name: 'DK', display: 'Denmark' },
{ name: 'FJ', display: 'Fiji' },
{ name: 'SG', display: 'Singapore' },
{ name: 'TG', display: 'Togo' },
{ name: 'TO', display: 'Tonga' },
{ name: 'BN', display: 'Brunei Darussalam' },
{ name: 'GL', display: 'Greenland' },
{ name: 'SL', display: 'Sierra Leone' },
{ name: 'SZ', display: 'Eswatini' },
{ name: 'KI', display: 'Kiribati' },
{ name: 'KM', display: 'Comoros' },
{ name: 'LU', display: 'Luxembourg' },
{ name: 'TJ', display: 'Tajikistan' },
{ name: 'HK', display: 'Hong Kong' },
]
Other Optional Features:
Cloud Proxy Manager Initial setup Hosting the Proxy Manager on our Cloud servers with remote server access lets Bright Data host the servers for you.
Read more about the Proxy Manager on our FAQ.
Check the available endpoints on our Proxy manager API documentation.
Read more about the Cloud Proxy Manager on our FAQ.
The Cloud Proxy Manager should be already added automatically to your CP, If you don’t have any servers installed - you should contact your account manager.

Before doing any action in Cloud Proxy Manager, you should add your IP to the admin's whitelist
Open the cp/lpm page
Click the open button on the Cloud Proxy Manager row
Click on the General settings button
In the General settings page, add your IP to the Admin whitelisted IPs
You can check your IP here

White labeling:
Use this method to brand your proxies with your own domain/company name
To brand the proxies under your domain follow these steps:
Open the DNS configuration for your domain.
Create a CNAME Record pointing to the domain.
Brightdata (Default)
CNAME
brd.x.proxiess.com
22225
Brightdata EU
CNAME
brdeu.x.proxiess.com
22226
Brightdata Asia
CNAME
brdasia.x.proxiess.com
22227
Whatever you enter in the name/host will decide the domain which points to our API IP.
Thus if your domain is API.com and you enter the host premium or whatever you want to call it pointing to the PacketStream domain, your proxies will be formatted premium.yourdomain.com:port:user:pass
An example on Godaddy is linked below:

FAQ
What is Authorization?
This is a header value you provide with every request. We are using the Bearer token so send in the header like this: "Authorization: Bearer <your API token>"
Im getting this error:
{"message":"username cannot be null or undefined.","timestamp":1634146255996}
how do I fix it?
Make sure you have this "Content-Type": "application/json"
header present in your requests.
Headers
Please check on how to send requests with headers in whichever languages you are using.
POST Request:
{
"Authorization": "Bearer <your api token>",
"Content-Type": "application/json"
}
# Sample curl request
curl --location --request POST 'https://core-proxy-service-w34nvoxnwq-uc.a.run.app/proxy_api/v1/brightdata/users/create' \
--header "Authorization: Bearer <your api token>" \
--header "Content-Type: application/json" \
--data-raw '{
"data_gb": 1
}'
GET Request:
{
"Authorization": "Bearer <your api token>",
}
# Sample curl request
curl --location --request GET 'https://core-proxy-service-w34nvoxnwq-uc.a.run.app/proxy_api/v1/brightdata/users/<userId>' \
-H "Authorization: Bearer <your api token>"
Last updated