AI agents for Browserbase

Search the web

Searches the web and returns up to 10 (at most 25) results, each with title, url, author, publishedDate, image and favicon, but no page text.

Fetch a page

Fetches one web page without running its JavaScript and returns its content as Markdown (the default), the raw body, or JSON shaped by a schema you give.

Get an agent run

Reads one agent run: its status (PENDING, RUNNING, COMPLETED, FAILED, STOPPED, TIMED_OUT or PAUSED), the result once it is COMPLETED, the cause of a failure.

List agent runs

Lists agent runs, newest first, optionally by status or agent, with each run's runId, task, status, result and times.

Read an agent run's messages

Returns what an agent run said and did, oldest first: its text, its reasoning and its tool calls (search, navigate, click, type) with their results, each as message with a role and content.

List browser sessions

Lists the project's browser sessions, optionally only those with one status.

Run a browser agent

Starts a Browserbase agent that completes a task written in plain words by searching and using a real browser: clicking, typing, filling forms and reading pages.

Answer a paused agent run

Resumes a PAUSED agent run with your answer to its question (a verification code, an approval, a choice), given as reply, and optionally more variables.

Stop an agent runDeletes data

Asks a running agent run to stop; it winds down and ends as STOPPED.

End a browser sessionDeletes data

Closes a running browser session (status REQUEST_RELEASE), which stops its billing; whatever a script or person was doing in it stops too.