DocsVideo Recordingbrowser_get_live_frame

browser_get_live_frame

browser_get_live_frame

Get the latest frame from a live video stream as a base64-encoded image. Useful for capturing single frames without recording a full video.

When to use browser_get_live_frame

Use browser_get_live_frame when you need to record or stream a live browser session. It is part of Owl Browser's Video Recording toolset and runs inside a self-hosted, source-level stealth engine, so every call uses the same configured fingerprint controls as the rest of your automation. Detection still depends on the site, network, behavior, and profile consistency.

Usage Example

12345678910
import asyncio
from owl_browser import OwlBrowser, RemoteConfig
# Async usage
async with OwlBrowser(config) as browser:
context_id = await browser.create_context()
await browser.get_live_frame(
context_id=context_id
)

Parameters

Required

context_idstringrequired

The unique identifier of the browser context (e.g., 'ctx_000001')

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}

Frequently Asked Questions

What does browser_get_live_frame do?

Get the latest frame from a live video stream as a base64-encoded image. Useful for capturing single frames without recording a full video. It belongs to Owl Browser's Video Recording category and is available through the REST API, the Python SDK (browser.get_live_frame()), the Node.js SDK, and the MCP server.

What parameters does browser_get_live_frame accept?

browser_get_live_frame accepts 1 required parameter (context_id) and 0 optional parameters. All parameters are sent as JSON in a POST request to /api/execute/browser_get_live_frame.

Is browser_get_live_frame detectable by anti-bot systems like Cloudflare or DataDome?

No. browser_get_live_frame executes inside Owl Browser's Chromium engine, which applies fingerprint spoofing at the C++ source level rather than through JavaScript patches. Every tool call shares the same consistent, human-like fingerprint, so anti-bot systems such as Cloudflare, DataDome, and Akamai see an ordinary browser.

Related Tools

Browse the full Owl Browser API reference or get started with the Python SDK and Node.js SDK.