Create Session

POST
Creates a new session and returns session details including a unique session ID. A session remains active for 10 minutes of inactivity.

Request

This endpoint expects an object.
urlstringRequired
The URL to create or continue session from.
localbooleanOptional
Boolean flag to indicate if session to be run locally or in the cloud (Default: False). If set to true, the session will be run locally via your chrome extension. If set to false, the session will be run in the cloud.
agent_idstringOptional
The agent id to use for the session.
mode"fast" or "standard"Optional
Allowed values: faststandard
The mode you would like to use for the session. 'fast' or 'standard'
use_proxybooleanOptional
Boolean flag to use a proxy for the session (Default: False). Each Session gets a new Residential IP.
browser_paramsobjectOptional
Object containing height and width for the browser screen size.
include_screenshotbooleanOptional
optional_paramsmap from strings to anyOptional
Additional optional parameters for the session.

Response

This endpoint returns an object.
statusstring

The final status of the browsing session. One of [“CONTINUE”, “ASK_USER”, “DONE”]

messagestring
A message providing more details about the session status.
session_idstring
The unique identifier for the session.
urlstring
The URL associated with the session.
screenshotstring
image url of the screenshot taken during the session.