Skip to main content
POST
Page Actions

Page Actions

Every running session exposes action endpoints that execute real CDP commands inside the browser. All actions require session authentication and return the standard { "data": ... } envelope. POST /v1/sessions/{id}/navigate
string
required
Absolute URL to navigate to.
string
default:"load"
Lifecycle event to wait for: load, domcontentloaded, or none. (wait is accepted as an alias.)
number
default:"30"
Navigation timeout in seconds.
Response

Execute Script

POST /v1/sessions/{id}/execute
string
required
JavaScript evaluated in the page context. Promises are awaited; the resolved value is returned.
Response

Click

POST /v1/sessions/{id}/click
string
required
CSS selector of the element to click.

Type

POST /v1/sessions/{id}/type
string
required
CSS selector of the input element.
string
required
Text to type. The element’s value is replaced and input/change events are dispatched.

Extract

POST /v1/sessions/{id}/extract
string
default:"body"
CSS selector of elements to extract.
string
default:"text"
text (innerText) or html (outerHTML).
number
Truncate the combined content to this many characters.
Response

Wait For Selector

POST /v1/sessions/{id}/wait
string
required
CSS selector to wait for.
number
default:"30000"
Maximum wait in milliseconds. Returns 504 on timeout.

Scroll

POST /v1/sessions/{id}/scroll
string
default:"down"
up, down, top, or bottom.
number
default:"500"
Pixels to scroll for up/down.

Errors