Puppeteer proxy integration

Puppeteer Proxy Integration

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:22225.
  • 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:22225']


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

  • 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.
    The local host IP is
    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=']


const page = await browser.newPage();

await page.goto('http://lumtest.com/myip.json');

await page.screenshot({path: 'example.png'});

await browser.close();


Get proxies for Puppeteer

Proxy badges

Powered by an award-winning proxy infrastructure

Over 72 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

  • 72,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 in the world
  • Verify mobile ads & crawl mobile sites

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

Category leader in proxies

650TB of public data collected every day

Number of ISP proxies

New feature releases every day

Serving 7/10 universities

Serving 7/10 of the world’s leading universities

Trust pilot ratings
4.6/5 Trustpilot rating

Ready to get Puppeteer proxies?

Puppeteer proxies FAQ

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.

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.

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.

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.

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.

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.