Send Your First Request with Bright Data's Web Unlocker

​

Getting access to Web Unlocker

Bright data offers two methods to use web unlocker in your scraping task:

1. Use an HTTPS proxy access point

2. New: Beta Release: Use an HTTPS Web API access point

​

Accessing Web Unlocker as HTTPS proxy

In order to access the web unlocker you will need to provide credentials which are comprised of:

1. Your customer ID

2. Your web unlocker zone name

3. Your web unlocker password

4. Bright Data SSL certificate

​

Customer ID

Customer ID can be found in the welcome email you received, or by clicking your account initial letter on the top right screen of your control panel, or by clicking here: Account settings .

​

Zone name and password

You zone name and password can be found in the overview tab of your unlocker zone in control panel.

​

Bright Data SSL Certificate

SSL Certificate can be found by clicking “SSL certificate” wizard on your zone’s overview top menu. See further instructions here: SSL certificate.

Alternatively, you can ignore SSL errors.

​

Web Unlocker: HTTPS Proxy code examples

Once you have your credentials, use the following code to send your first request:

{

"ip": "ALLOCATED_IP",

"country": "PK",

"asn": {

"asnum": 203020,

"org_name": "HostRoyale Technologies Pvt Ltd"

},

"geo": {

"city": "Islamabad",

"region": "IS",

"region_name": "Islamabad",

"postal_code": "44040",

"latitude": 33.7233,

"longitude": 73.0435,

"tz": "Asia/Karachi",

"lum_city": "islamabad",

"lum_region": "is"

}

}

​

Accessing Web Unlocker as API endpoint - Beta release

In order to access the web unlocker you will need to provide credentials which are comprised of:

1. Your web unlocker zone name

2. A Bright Data API key

​

Zone name

You zone name can be found in the overview tab of your unlocker zone in control panel.

​

Bright Data API Key

Bright Data API key is a generated secret hash which is used to authenticate your access to the web unlocker service via the web API endpoint. To generate the API key click here to get to Account settings , scroll down and click the “Add token” button, and follow the instructions on screen.

We strongly recommend to have an expiration date set on your token for increased security.

​

Web Unlocker: API Endpoint code examples

To use Web Unlocker via the API endpoint you should use the following parameters:

1. API Endpoint: https://api.brightdata.com/request

2. API Key

3. Web Unlocker zone name

4. Target URL

5. Response format: raw

curl -H "Content-Type: application/json" -H "Authorization: Bearer [my API key]" -d '{"zone": "[my_webunlocker_zone]","url": "[target URL]", "format": "raw"}' https://api.brightdata.com/request