1

Get your API Key

Go over the Dashboard’s Settings tab:

Then copy your API Key directly from the input and update your .env by adding the BROWSERBASE_API_KEY entry

Alternatively, you can temporarily set the environment variable for a single bash command by prefixing it with BROWSERBASE_API_KEY=<your_api_key> in your terminal.

2

Install Puppeteer

npm i puppeteer-core

3

Update your code or clone a template

Running your existing code with Browserbase only requires a few line changes:

import puppeteer from "puppeteer-core";

(async () => {
const browser = await puppeteer.connect({
  browserWSEndpoint:
  `wss://connect.browserbase.com?apiKey=${process.env.BROWSERBASE_API_KEY}`
});

const pages = await browser.pages();
const page = pages[0];

await page.goto("https://www.browserbase.com");
await page.close();
await browser.close();
})().catch((error) => console.error(error.message));
Be sure to set your BROWSERBASE_API_KEY environment variable to the value you copied from the Dashboard.

Get started with a Puppeteer Node.js template

Clone this GitHub repo to get started with Puppeteer

4

Inspect the completed Session

You can find all the recent sessions on the Dashboard’s Overview, along with essential metrics:

Select your Session to inspect it with the Session Inspector.

Start building