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.

Start free trial

Start free with Google

No credit card required

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

Start free trial

Start with Google

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

Start free trial

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.

Top proxy locations

Residential IPs

Mobile IPs

Datacenter IPs

ISP IPs

View all proxy locations

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

Residential proxies

Datacenter Proxies

770,000+ IPs
Available in 98 countries
Shared and dedicated IP pools available
Access & crawl all sophisticated websites

Datacenter proxies

ISP Proxies

700,000+ IPs
Available in 35 countries
Real static residential IPs without IP rotation
Best for logging into multiple accounts

ISP proxies

Mobile Proxies

7,000,000+ IPs
Available in 195 countries
Largest real-peer 3G/4G IP network
Verify mobile ads & crawl mobile sites

Mobile proxies

Proxy Network Pricing

Use code RESI50 at checkout to get 50% OFF Residential Proxies for six months!

Start Now

50% OFF

PAY AS YOU GO

$8.4 $4.2 / GB

No commitment

Start free trial

Use this coupon code: RESI50

Use our proxies without monthly commitment

50% OFF

138 GB Included

$7.14 $3.57 / GB

$499 Billed monthly

Start free trial

Use this coupon code: RESI50

Perfect for small businesses with moderate usage

50% OFF

316 GB Included

$6.3 $3.15 / GB

$999 Billed monthly

Start free trial

Use this coupon code: RESI50

Designed for large teams with extensive operational needs

50% OFF

678 GB Included

$5.88 $2.94 / GB

$1999 Billed monthly

Start free trial

Use this coupon code: RESI50

Optimized for enterprises running large-scale operations

Need more than 1 TB?

Unlimited scale
Unlimited seats
Premium SLA
99.99% Network Uptime
Free Proxy Manager
Complete data coverage
Custom price per GB
Custom solutions

We accept these payment methods:

The best customer experience in the industry

You ask, we develop

New feature releases every day

24/7 global support

To answer any questions right when you need it

Full transparency

Real-time network performance dashboard

Dedicated Account Managers

To optimize your performance

Tailored solutions

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

4.6/5 Trustpilot rating

Ready to get Puppeteer proxies?

Start free trial

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.