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.

API documentation: https://core-proxy-service-w34nvoxnwq-uc.a.run.app/api

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 .

API	Authentication	Domain	Port
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

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 .

API	Authentication	Domain	Port
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

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:

1. Open the DNS configuration for your domain.

2. Create a CNAME Record pointing to the domain.

API	Record Type	Domain	Port
Brightdata (Default)	CNAME	brd.x.proxiess.com	22225
Brightdata EU	CNAME	brdeu.x.proxiess.com	22226
Brightdata Asia	CNAME	brdasia.x.proxiess.com	22227

1. Whatever you enter in the name/host will decide the domain which points to our API IP.

2. 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

3. 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>"