Start your first Session with Playwright

Get started with a Playwright Node.js template

Clone this GitHub repo to start using Browserbase with Playwright in Node.

Get started with a Playwright Python template

Clone this GitHub repo to start using Browserbase with Playwright in Python.

1. Get your API Key

   Your API key and Project ID are displayed in the Dashboard Navigation row:

   

   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 Playwright

   Node.js

   npm i playwright-core @browserbasehq/sdk
   

   Bun does not currently support Playwright.

   Python

   pip install playwright browserbase
   
3. Update your code or clone a template

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

   Node.js

   import { chromium } from "playwright-core";
   import Browserbase from "@browserbasehq/sdk";
   
   const bb = new Browserbase({
     apiKey: process.env.BROWSERBASE_API_KEY,
   });
   
   (async () => {
     const session = await bb.sessions.create();
     console.log(`Session created, id: ${session.id}`);
   
     const browser = await chromium.connectOverCDP(session.connectUrl);
     const defaultContext = browser.contexts()[0];
     const page = defaultContext.pages()[0];
   
     await page.goto("https://www.browserbase.com/", {
       waitUntil: "domcontentloaded",
     });
   
     const debugUrls = await bb.sessions.debug(session.id);
     console.log(
       `Session started, live debug accessible here: ${debugUrls.debuggerUrl}.`,
     );
   
     console.log("Taking a screenshot!");
     await page.screenshot({ fullPage: true });
   
     console.log("Shutting down...");
     await page.close();
     await browser.close();
   
     console.log(
       `Session complete! View replay at https://browserbase.com/sessions/${session.id}`,
     );
   })();
   

   Be sure to set your BROWSERBASE_API_KEY in the environment variables.

   Python

   from playwright.sync_api import Playwright, sync_playwright
   from browserbase import Browserbase
   import os
   
   bb = Browserbase(api_key=os.environ["BROWSERBASE_API_KEY"])
   
   
   def run(playwright: Playwright) -> None:
       session = bb.sessions.create()
       print("Session replay URL:", f"https://browserbase.com/sessions/{session.id}")
   
       chromium = playwright.chromium
       browser = chromium.connect_over_cdp(session.connect_url)
       context = browser.contexts[0]
       page = context.pages[0]
   
       page.goto("https://browserbase.com/")
       page_title = page.title()
       print(page_title)
   
       page.close()
       browser.close()
       print("Done!")
   
   
   if __name__ == "__main__":
       with sync_playwright() as playwright:
           run(playwright)
   

   Be sure to set your BROWSERBASE_API_KEY in the environment variables.

   
   
4. Inspect the completed Session

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

   

   Select your Session to inspect it with the Session Inspector.

Start building

Using Browser Sessions

Learn how to connect to and interact with browser sessions effectively.

Managing Sessions

Understand how to properly end sessions and manage their lifecycle.