Send Your First Request with Bright Data's 网络解锁器

Learn how to send your first API request using Bright Data’s 网络解锁器 with easy-to-follow code examples in multiple programming languages.

Getting access to 网络解锁器

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 网络解锁器 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

Prevent SSL errors by setting up 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.

网络解锁器: HTTPS Proxy code examples

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

Expand for code examples

cURL

curl  "http://lumtest.com/myip.json"  --proxy brd.superproxy.io:33335  --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>

上面的代码使用住宅代理向 http://lumtest.com/myip.json发送请求。 它以 JSON 格式返回您的 IP 信息：

输出

{

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

}

}

Now, replace “https://lumtest.com/myip.json” with the website of your choice.

Accessing 网络解锁器 as API endpoint - Beta release

Access via API endpoint is a new feature, released as beta

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 API key” button, and follow the instructions on screen.

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

The API key will be shown to you on the screen only so make sure you copy and store it in a safe location per your organization’s policies

网络解锁器: API Endpoint code examples

To use 网络解锁器 via the API endpoint you should use the following parameters:

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

2. API Key

3. 网络解锁器 zone name

4. Target URL

5. Response format: raw

cURL

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