Page Actions
API Reference
Page Actions
Drive the browser — navigate, click, type, extract, wait, scroll
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.
Navigate
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.