Your AI team, working in Browserbase

Browserbase is a serverless platform that enables developers to run, manage, and monitor headless browsers at scale, offering seamless integration with tools like Playwright, Puppeteer, and Selenium.

Start your company

What your team can do in Browserbase

73 tools to work with, connected with an API key.

Attach Browserbase Function Secret

Attach an existing project secret to a Function by UUID. Takes effect on the Function's next invocation. Re-attaching an already attached secret succeeds. Returns a local success confirmation for HTTP 204 No Content, HTTP 400 for invalid UUIDs, or HTTP 404 if the Function or secret does not exist in the project.

Contexts create

Deprecated compatibility action. Use CREATE_CONTEXT.

Contexts getReads only

Deprecated compatibility action. Use GET_CONTEXT.

Create Browser Context

Create a reusable browser context; the API key can select the project.

Create browser session

Deprecated compatibility action. Use CREATE_SESSION.

Create Browser Session

Create an isolated Browserbase session and return its connection details.

Create Browserbase Agent

Create a reusable browser agent with a name and optional system prompt and result schema. Use the returned agentId when starting runs to reuse its configuration. An agent without a system prompt behaves like an unconfigured run.

Create Browserbase Webhook

Register a publicly reachable HTTPS endpoint for project event deliveries. An endpoint can only be registered once per project. Store the signing secret returned here: it is only shown on creation and secret rotation.

Delete a browser context

Tool to delete a browser context and all its stored data (cookies, localStorage, etc.). Use when you need to permanently remove a context.

Delete a browser extension

Tool to delete an uploaded browser extension by its ID. Use when you need to remove an extension from Browserbase.

Delete Browserbase Agent

Delete a reusable browser agent by its agentId. Runs that already referenced the agent are unaffected. Deleting an already-deleted or nonexistent agent also succeeds. Returns an empty result.

Delete Browserbase Webhook

Delete a webhook, immediately stopping deliveries and retiring its secret. Earlier events are not replayed if the endpoint is registered again.

Delete Download

Delete a download file from storage and mark it as deleted. Supply the download ID. Returns an empty object on success.

Delete Session Downloads

Tool to delete all file downloads from a specific browser session. Use when you need to clean up session artifacts or free storage space.

Detach Browserbase Function Secret

Detach a project secret from a Function by UUID. Takes effect on the Function's next invocation. Detaching a secret that is not attached succeeds. Returns a local success confirmation for HTTP 204 No Content, HTTP 400 for invalid UUIDs, or HTTP 404 if the Function does not exist in the project. Does not delete the project secret.

Download Session ArtifactsReads only

Download a completed session's generated files as a ZIP archive.

Fetch Browserbase PageReads only

Fetch a page and return its content, headers, and metadata.

Get Browser ContextReads only

Return metadata for a browser context by ID.

Get Browser SessionReads only

Return status, connection details, and timestamps for a browser session.

Get Browserbase AgentReads only

Retrieve a reusable browser agent by its agentId. Returns its name, timestamps, and configured system prompt and result schema.

Get Browserbase Agent RunReads only

Retrieve a browser agent run's current status, result, and session details. Use List Run Messages separately to retrieve the run's messages.

Get Browserbase FunctionReads only

Retrieve a Browserbase function by its ID. Returns its name, owning project ID, and creation and update timestamps.

Get Browserbase Function BuildReads only

Retrieve a Browserbase function build by its build ID. Returns its status, original request, timestamps, and produced functions and versions or failure cause when available.

Get Browserbase Function Build LogsReads only

Retrieve Browserbase function build logs by the build ID. Returns log messages, their numeric timestamps, and the total log count.

Get Browserbase Function VersionReads only

Retrieve a Browserbase function version by its version ID. Returns its project, function, build, timestamps, and configured session creation parameters and user parameter schema when present.

Get Browserbase InvocationReads only

Retrieve a Browserbase function invocation by its invocation ID. Returns its status, function and session IDs, timestamps, and execution region, parameters, results, and failure cause when present.

Get Browserbase Invocation LogsReads only

Retrieve Browserbase function invocation logs by the invocation ID. Returns log messages, their numeric timestamps, and the total log count.

Get Browserbase KeypairReads only

Retrieve the project's public HPKE encryption key and keypair ID. Use publicKey to encrypt secret values before creating a secret, and pass the returned id as keypairId so decryption supports keypair rotation.

Get Browserbase ProjectReads only

Return project metadata, default timeout, and assigned concurrency.

Get Browserbase SecretReads only

Retrieve a project secret's ID and name by UUID, without its secret value. Returns HTTP 400 for an invalid UUID and HTTP 404 if the secret does not exist in the project.

Get Browserbase WebhookReads only

Retrieve a single webhook by ID, without its signing secret. The signing secret is only returned when creating a webhook or rotating it.

Get CertificateReads only

Retrieve a Browserbase certificate by its ID. Returns the certificate's ID, creation and update timestamps, and project ID.

Get DownloadReads only

Get a single download by ID as metadata or a downloadable file object. Select application/json for metadata or application/octet-stream for the file. This retrieves one file, rather than the ZIP of all session artifacts.

Get project usage statisticsReads only

Tool to retrieve usage statistics for a project including browser minutes and proxy bytes consumed. Use when you need to monitor or track resource usage for a specific project.

Get Session Debug URLsReads only

Return live debugger and WebSocket URLs for a running browser session.

Get Session LogsReads only

Return network request and response events captured during a browser session.

Get Session ReplayReads only

Return HLS replay metadata and page playlist paths for a recorded session.

Get Session Replay PageReads only

Return the HLS M3U8 playlist for one recorded replay page. Consume its short-lived signed media URLs promptly rather than storing them.

Invoke Browserbase Function

Invoke a deployed Browserbase function asynchronously. Returns the accepted invocation (HTTP 202), not its eventual result. Optionally pass function parameters and configure its browser session.

List Browser SessionsReads only

List browser sessions, optionally filtered by status or user metadata.

List Browserbase Agent RunsReads only

List a page of browser agent runs across your account. Filter by status, referenced agent, or inclusive creation-time bounds. Continue pagination by passing the returned nextCursor as cursor.

List Browserbase AgentsReads only

List one page of reusable browser agents across your account. Filter by inclusive creation timestamps using startAt and endAt. Pass the returned nextCursor as cursor to continue paging until nextCursor is null.

List Browserbase DownloadsReads only

List one page of download metadata for a required browser session. Filter by exact filename, MIME type, file size, or inclusive creation timestamps. Use limit and offset to paginate through the total matches.

List Browserbase Function BuildsReads only

List one page of Browserbase function builds, optionally filtered by status. Use offset and limit to paginate; total reports the number of matching builds. Results include build status, timestamps, and any built functions or failure cause.

List Browserbase Function SecretsReads only

List one page of secret IDs and names attached to a Browserbase function, optionally filtered by creation time. Pass nextCursor as cursor with the same filters to continue paging; a null nextCursor means there are no more results.

List Browserbase Function Version InvocationsReads only

List one page of invocations for a Browserbase function version by its UUID. Filter by status and paginate using offset and limit. Each invocation includes its status, function and session IDs, timestamps, and any stored results.

List Browserbase Function VersionsReads only

List one page of versions for a Browserbase function by its UUID. Use offset and limit to page through results; total reports the total number of versions. Each version includes its build ID and stored parameter schemas.

List Browserbase FunctionsReads only

List one page of Browserbase functions and the total number available. Use offset and limit to paginate. Pass a returned function id to invoke it.

List Browserbase ProjectsReads only

List projects with their default timeout and assigned concurrency.

List Browserbase Run MessagesReads only

List a page of a browser agent run's messages, oldest first, with assistant or tool roles and text or typed content parts. Pass nextSince as since to continue paging or poll for new messages; use all to ignore the page limit.

List Browserbase SecretsReads only

List one page of project secret IDs and names, optionally filtered by creation time. Does not return secret values. Pass nextCursor as cursor to fetch the next page; a null nextCursor means there are no more results. Time bounds are inclusive.

List Browserbase WebhooksReads only

List one page of the project's webhooks, newest first, without signing secrets. Pass nextCursor as cursor to fetch the next page. A null nextCursor ends paging.

List CertificatesReads only

List Browserbase certificates with their IDs, timestamps, and project IDs.

List Recording DownloadsReads only

Poll per-page MP4 assembly after requesting recording downloads until every page is COMPLETED or FAILED. Completed standard-storage pages may include short-lived signed MP4 URLs; BYOS pages may complete without a URL.

Release Browser Session

Irreversibly request release of a running browser session, ending it before its configured timeout to avoid further charges.

Request Recording DownloadsReads only

Start asynchronous MP4 assembly for every recorded page of a completed session, then poll List Recording Downloads until every page is COMPLETED or FAILED.

Resume Browserbase Agent Run

Resume only a PAUSED browser agent run with optional additional input. The task answers its trailing pause tool call; variables merge over the run's original variables. A run that is not PAUSED returns HTTP 409 conflict. Returns the accepted RUNNING run; poll the run for its next state.

Retrieve a browser extensionReads only

Tool to retrieve details of a specific browser extension. Use when you have an extension ID and need its metadata (file name, timestamps, project ID).

Run Browserbase Agent

Start a browser agent run to complete a task using web search and browser tools. Returns the newly created pending run, not its eventual result. Optionally use a custom agent, configure its browser, supply variables, or enable pauses.

Sessions getReads only

Deprecated compatibility action. Use GET_SESSION.

Sessions get debugReads only

Deprecated compatibility action. Use GET_SESSION_DEBUG_URLS.

Sessions get downloadsReads only

Deprecated compatibility action. Use DOWNLOAD_SESSION_ARTIFACTS.

Sessions get logsReads only

Deprecated compatibility action. Use GET_SESSION_LOGS.

Sessions listReads only

Deprecated compatibility action. Use LIST_SESSIONS.

Sessions update

Deprecated compatibility action. Use RELEASE_SESSION.

Stop Browserbase Agent Run

Request that an in-progress browser agent run stop. Returns the run after the stop request is accepted, not confirmation that it has stopped. The run winds down and transitions to STOPPED; poll Get Run until its status is STOPPED to confirm. Already-finished runs return HTTP 409 conflict.

Update Browser Context

Tool to update a specific browser context. Use when you need fresh upload URL and encryption details for an existing context, after obtaining a valid context ID.

Update Browserbase Agent

Update a reusable browser agent's name, system prompt, or result schema. Only supplied fields are modified; omitted fields remain unchanged. Returns the updated agent, whose defaults apply to subsequent runs referencing it.

Update Browserbase Webhook

Update a webhook's delivery URL, subscribed event types, or both. Omitted fields stay unchanged. Event types replace the existing subscription rather than adding to it. The signing secret is unaffected and not returned.

Upload Browser Extension

Tool to upload a browser extension for use in sessions. Supports Chrome extension format (ZIP). Use when you need to add custom browser extensions to your Browserbase project.

Upload Session File

Upload one file so browser interactions can select it in a file input field.

Upload Session Files

Upload multiple files to one browser session for file-input interactions. Reports per-file outcomes when at least one upload succeeds; a batch-level provider error can stop further attempts.

Web SearchReads only

Perform a web search and return structured results.

More in Web scraping & browser

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or