Puppeteer Proxy Integration
Integrating Puppeteer with Bright Data proxies enhances your web scraping capabilities by providing secure, efficient, and flexible proxy management.
This guide may be outdated. For an up-to-date guide please see our documentation.
- 150M+ Residential IPs
- Sticky and rotating sessions
- 99.95% success rate
- Geo-location targeting - FREE
Watch our youtube video for a step by step guide on how to integrate Bright Data proxies with Puppeteer
New Bright Data product: Scraping Browser
Puppeteer Compatible
Easily make an API call to fetch any number of browser sessions and interact with them using Puppeteer (Python), Playwright (Node.js), or Selenium over a CDP protocol. Ideal for scraping projects that require website interactions to retrieve data, like hovering over a page, clicking buttons, scrolling, adding text, etc.
To learn more about Scraping Brower
Puppeteer proxy integration with Bright Data
- Begin by going to your Bright Data Dashboard and clicking ‘create a Zone’.
- Choose ‘Network type’ and click save.
- Within Puppeteer fill in the ‘Proxy IP:Port’ in the ‘proxy-server’ value, for example brd.superproxy.io:33335.
- Under ‘page.authenticate’ input your Bright Data account ID and proxy Zone name in the ‘username’ value, for example: brd-customer-CUSTOMER-zone-YOURZONE and your Zone password found in the Zone settings.
- For example:
const puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.launch({
headless: false,
args: ['--proxy-server=brd.superproxy.io:33335']
});
const page = await browser.newPage();
await page.authenticate({
username: 'brd-customer-[customer_ID]-zone-[zone_name]',
password: '[zone_password]'
});
await page.goto('http://lumtest.com/myip.json');
await page.screenshot({path: 'example.png'});
await browser.close();
})();
Proxy Manager and Puppeteer integration (Optional)
Important: Using Proxy Manager is optional. You can easily use Puppeteer with Bright Data products without using the Proxy Manager.
- Create a Zone with the network, IP type, and number of IPs you wish to use.
- Install the Proxy Manager.
- Click ‘add new proxy’ and choose the Zone and settings you require, click ‘save’.
- In Puppeteer, under the ‘proxy-server’, input your local IP and Proxy Manager port (i.e. 127.0.0.1:24000)
The local host IP is 127.0.0.1
The port created in the Proxy Manager is 24XXX, for example, 24000 - Leave the username and password values empty, as the Bright Data Proxy Manager has already been authenticated with the Super Proxy.
- For example:
const puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.launch({
headless: false,
args: ['--proxy-server=127.0.0.1:24000']
});
const page = await browser.newPage();
await page.goto('http://lumtest.com/myip.json');
await page.screenshot({path: 'example.png'});
await browser.close();
})();
⚠️Important note! If you are using Bright Data’s Residential Proxies, Web Unlocker or SERP API, you need to install an SSL certificate to enable end-to-end secure connections to your target website(s). This is a simple process, see https://docs.brightdata.com/general/account/ssl-certificate#installation-of-the-ssl-certificate for instructions.
Get proxies for Puppeteer
Powered by an award-winning proxy infrastructure
Over 150 million residential IPs, best-in-class technology and the ability to target any country, city, ZIP Code, carrier, & ASN make our premium proxy services a top choice for developers.
About Bright Data proxies
Residential Proxies
- 150,000,000+ IPs
- Available in 195 countries
- The largest rotating real-peer IP network
- Access & crawl all sophisticated websites
Datacenter Proxies
- 770,000+ IPs
- Available in 98 countries
- Shared and dedicated IP pools available
- Access & crawl all sophisticated websites
ISP Proxies
- 700,000+ IPs
- Available in 35 countries
- Real static residential IPs without IP rotation
- Best for logging into multiple accounts
Mobile Proxies
- 7,000,000+ IPs
- Available in 195 countries
- Largest real-peer 3G/4G IP network
- Verify mobile ads & crawl mobile sites
Proxy Network Pricing
- Unlimited scale
- Unlimited seats
- Premium SLA
- 99.99% Network Uptime
- Free Proxy Manager
- Complete data coverage
- Custom price per GB
- Custom solutions
- Unlimited scale
- Unlimited seats
- Premium SLA
- 99.99% Network Uptime
- Free Proxy Manager
- Complete data coverage
- Custom price per GB
- Custom solutions
- Unlimited scale
- Unlimited seats
- Premium SLA
- 99.99% Network Uptime
- Free Proxy Manager
- Complete data coverage
- Custom price per GB
- Custom solutions
- Unlimited scale
- Unlimited seats
- Premium SLA
- 99.99% Network Uptime
- Free Proxy Manager
- Complete data coverage
- Custom price per GB
- Custom solutions
The best customer experience in the industry
New feature releases every day
To answer any questions right when you need it
Real-time network performance dashboard
To optimize your performance
To meet your data collection goals
The category leader in proxies and data collection
650TB of public data collected every day
New feature releases every day
Serving 7/10 of the world’s leading universities
Ready to get Puppeteer proxies?
Puppeteer proxies FAQ
What are Puppeteer proxies?
Puppeteer proxies are essentially the integration of proxy servers with Puppeteer, a Node.js library that provides a high-level API to control Chrome or Chromium over the DevTools Protocol. Puppeteer is often used for web scraping or automating browser tasks.
What kind of Puppeteer proxies does Bright Data offer?
When you use Bright Data’s proxies with Puppeteer, you’re able to route your requests through our vast network of residential, datacenter, ISP, or mobile IPs. This allows you to access geo-restricted content, reduce the chance of being blocked or served misleading information, and maintain a high level of anonymity.
Does Bright Data offer rotating Puppeteer proxies?
Bright Data’s proxies handle IP rotation automatically, so you don’t need to worry about it. Our system ensures that you get a new IP address for each request or after a certain period of time, depending on your settings.
Can I take screenshots of web pages while using Bright Data's proxy with Puppeteer?
Yes, you can take screenshots of web pages while using Bright Data’s proxy with Puppeteer. Once you’ve navigated to the desired page using the proxy settings, you can use Puppeteer’s page.screenshot() function to capture the page.
What steps are involved in integrating Puppeteer with Bright Data's Proxy Manager?
To integrate Puppeteer with Bright Data’s Proxy Manager, create a Zone specifying the network and IP type, install the Proxy Manager, add a new proxy with the desired settings, and use your local IP and the Proxy Manager port in Puppeteer’s ‘--proxy-server’ argument.
What is the new Bright Data Scraping Browser product?
The new Bright Data Scraping Browser is a tool that allows you to fetch and interact with browser sessions via APIs compatible with Puppeteer (Python), Playwright (Node.js), or Selenium using the Chrome DevTools Protocol. It’s ideal for complex scraping tasks that require interactive web page actions.