Getting started

In this guide, we’ll cover the basics of using Browserbase. By the end, you’ll run your first browser session and have a basic understanding of how to use Browserbase.

​

Creating Your Account

First, you need to sign up for a Browserbase account. The free plan includes:

• One browser session running at a time
• 60 minutes of browser time per month

​

Overview Dashboard

The Overview Dashboard is the first page you’ll see when you log in to Browserbase. It gives you a quick overview of your browser sessions, usage, and status.

On the overview page, you’ll find:

• Your project ID and API key are on the right side
• List of currently running and recently completed sessions
• Historical usage statistics
• Performance metrics
• Current system status

​

Using the Playground

Next, you’ll go to the Playground, which provides a quick way to try Browserbase directly in your browser. It’s a great way to get started and see how Browserbase works.

1. Navigate to the Playground
2. Command + Click on one of the templates in the code editor
3. Click the “Run” button to start a browser session, this will start a new browser session and run the code in the editor.
4. Watch the session via the Live View on the right and interact with the browser.
5. Once the session is complete, click the “Stop” button to shut down the browser.

After completing a session in the Playground, click the “View Session” button to open the Session Inspector.

​

Session Inspector

You can use the Session Inspector to watch sessions in real-time, view replays, or inspect the session logs.

​

Sessions List

You can always find a list of your sessions in the Sessions tab. From there, you can access the Session Inspector for any session.

If you know your session ID, you can also access the Session Inspector by navigating to https://www.browserbase.com/sessions/[session-id].

​

Next Steps

Running your first session in the Playground is a great way to get started. However, you’ll likely want to integrate Browserbase into your own codebase.

The first step is to select a browser automation framework you’ll want to use to control the browser. Browserbase supports all popular frameworks. As well as many integrations with popular tools.

Choose the framework that best matches your needs and follow the framework-specific quick start guide to get a Browserbase project setup in your local development environment.