https://github.com/luminati-io/bright-data-web-unlocker-nodejs-project
Bright Data Web Unlocker Nodejs boilerplate code
https://github.com/luminati-io/bright-data-web-unlocker-nodejs-project
brightdata scraping unlocker
Last synced: 10 months ago
JSON representation
Bright Data Web Unlocker Nodejs boilerplate code
- Host: GitHub
- URL: https://github.com/luminati-io/bright-data-web-unlocker-nodejs-project
- Owner: luminati-io
- Created: 2025-05-07T14:46:35.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-21T20:32:01.000Z (10 months ago)
- Last Synced: 2025-07-21T22:27:02.414Z (10 months ago)
- Topics: brightdata, scraping, unlocker
- Language: JavaScript
- Homepage: https://brightdata.com/products/web-unlocker
- Size: 19.5 KB
- Stars: 2
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bright Data Web Unlocker Nodejs project
[](https://brightdata.com/)
[Edit in StackBlitz editor ⚡️](https://stackblitz.com/~/github.com/luminati-io/bright-data-web-unlocker-nodejs-project?file=index.js)
## Bright Data Web Unlocker API Example
This project demonstrates how to use Bright Data's [Unlocker API](https://brightdata.com/products/web-unlocker) to access websites through Bright Data [Unlocker API](https://brightdata.com/products/web-unlocker).
## Overview
This script helps you access websites with anti-bot protection or CAPTCHAs by using Bright Data's Web Unlocker to automatically bypass these obstacles.
### Using environment variables in StackBlitz
1. Select the `.env` file
2. Add the following variables:
- `BRIGHT_DATA_API_TOKEN`: Your Bright Data [API Token](https://docs.brightdata.com/general/account/api-token)
- `BRIGHT_DATA_ZONE`: Your Bright Data [Zone](https://brightdata.com/cp/zones) name (e.g., `web_unlocker1`)
### Direct configuration
Alternatively, edit the CONFIG object directly in the script:
```javascript
const CONFIG = {
apiToken: process.env.BRIGHT_DATA_API_TOKEN || 'YOUR_API_TOKEN', // Replace with your actual token
zone: process.env.BRIGHT_DATA_ZONE || 'web_unlocker1', // Replace with your zone
targetUrl: 'https://geo.brdtest.com/welcome.txt' // Replace with your target URL
};
```
## Running the example
1. Make sure you've configured your `API token` and `zone`
2. Run `node index.js` in the terminal
3. Check the console output for the results
## How it works?
1. The script makes a POST request to Bright Data's Unlocker API endpoint
2. It includes your authentication token and target URL
3. Bright Data's Web Unlocker accesses the target URL
4. The response is returned to your script and displayed in the console
## Troubleshooting
If you encounter errors:
- Verify your API token is correct
- Check that your zone name is valid
- Ensure your target URL is properly formatted
## Modifying the example
To request a different URL:
1. Update the `targetUrl` in the CONFIG object
2. Run the script again
## Additional resources
- [Bright Data Web Unlocker API](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction)
- [Get an API Token](https://docs.brightdata.com/general/account/api-token)
- [Manage Zones](https://brightdata.com/cp/zones)
**Note:** This is an example implementation for educational purposes. For production use, consider adding additional error handling, logging, and security measures.