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

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.

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

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:

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

PreviousPacketstreamNextSmart

Last updated