Get a live view link for a connected cloud browser
A link a person opens to watch the cloud browser your CDP connection is driving and take control of it: the same tabs, cookies and page.
Requires scope: browser
A link a person opens to watch the cloud browser your CDP connection is driving and take control
of it: the same tabs, cookies and page. Use it when a page needs a human, such as a login, a
one-time code or a captcha. live_view_url is a page; live_url is its WebSocket, for building
your own viewer. Both carry a viewer token (wbv_ and 64 hex characters) that works once and
expires 60 s after this call if unused; ask again for a new one.
While the person has control, your connection's input commands (Input.*), navigation
(Page.navigate, Page.reload, Page.navigateToHistoryEntry) and tab changes
(Target.createTarget, Target.closeTarget, Target.activateTarget) are answered with CDP error
-32001 instead of reaching the browser; reading the page keeps working. The viewer streams the
page and sends input only while it holds control. Watching is not billed beyond the session's
own per-minute price, and the live view ends when the session does. A browser that cannot take a
second viewer answers the live view's WebSocket with 409 ERR::REQUEST::CONFLICT.
Authorization
bearerAuth Authorization: Bearer <key>. Read the key from the SPICRAWL_API_KEY environment
variable; never hard-code or log it. spicrawl_test_… keys can never spend live
credits. Scopes: scrape, batch, sessions (granted by default), browser
and read (granted deliberately). A missing scope is 403 ERR::AUTH::INSUFFICIENT_SCOPE naming the scope.
In: header
Path Parameters
The session_id that POST /v1/browser/token returned for this connection. An unknown, closed or other organization's session answers 404 ERR::REQUEST::NOT_FOUND.
^bs[0-9a-f]{24}$Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/browser/sessions/bs4f0c2a9e1d7b38c65a0e9f12/live"{ "session_id": "string", "live_view_url": "https://api.spicrawl.com/v1/browser/live#wss%3A%2F%2Fapi.spicrawl.com%2Fv1%2Fbrowser%2Fsessions%2Fbs4f0c2a9e1d7b38c65a0e9f12%2Flive%3Ftoken%3Dwbv_...", "live_url": "wss://api.spicrawl.com/v1/browser/sessions/bs4f0c2a9e1d7b38c65a0e9f12/live?token=wbv_...", "expires_in": 60, "single_use": true}