createBrowserSession
Spin up a new cloud browser session.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
timeout | number | No | 60 | Session timeout in minutes (5–1440). Timer starts after the session is ready. |
proxy_location | ProxyLocation | No | undefined | Route browser traffic through a geographic proxy. |
extensions | Extensions[] | No | undefined | Browser extensions to install. Options: "ad-blocker", "captcha-solver". |
browser_type | PersistentBrowserType | No | undefined | Browser type. Options: "chrome", "msedge". |
Returns BrowserSessionResponse
| Field | Type | Description |
|---|---|---|
browser_session_id | string | Unique ID. Starts with pbs_. |
status | string | undefined | Current session status. |
browser_address | string | undefined | CDP address for connecting to the browser. |
app_url | string | undefined | Link to the live browser view in the Cloud UI. |
timeout | number | undefined | Configured timeout in minutes. |
started_at | string | undefined | When the session became ready. |
created_at | string | When the session was requested. |
Example: Chain multiple tasks in one session
getBrowserSession
Get the status and details of a session.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
browserSessionId | string | Yes | The session ID. |
Returns BrowserSessionResponse
getBrowserSessions
List all active browser sessions.
Returns BrowserSessionResponse[]
closeBrowserSession
Close a browser session and release its resources.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
browserSessionId | string | Yes | The session ID to close. |

