Live preview & recording - Browser Use

Wait for browser.ready as soon as you create the run so the URL is available while the browser is live:

from browser_use_sdk.v4 import BrowserUse

client = BrowserUse()
run = client.runs.create("Find the top Hacker News story")
ready = client.runs.wait_for_event(run.id, "browser.ready")
print(ready.data["live_view_url"])

import { BrowserUse } from "browser-use-sdk/v4";

const client = new BrowserUse();
const run = await client.runs.create({
  task: "Find the top Hacker News story",
  model: "grok-4.5",
});
const ready = await client.runs.waitForEvent(run.id, "browser.ready");
console.log(ready.data.live_view_url);

The helper advances the event cursor and times out after five minutes. See run events for the full event stream and custom polling.

Embed the live browser

<iframe
  src="{LIVE_VIEW_URL}"
  style="width: 100%; aspect-ratio: 16/9; border: 0;"
  allow="autoplay"
></iframe>

The URL is hosted on live.browser-use.com. Add that origin to your Content Security Policy’s frame-src directive when needed. Treat the URL as a credential: anyone with it can interact with the active browser.

Recording

Enable recording when the run creates its browser:

run = client.runs.create(
    "Test the checkout flow",
    browser_settings={"record": True},
)

const run = await client.runs.create({
  task: "Test the checkout flow",
  model: "grok-4.5",
  browserSettings: { proxyCountryCode: "us", record: true },
});

curl https://api.browser-use.com/api/v4/runs \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task":"Test checkout","browserSettings":{"record":true}}'

The MP4 becomes available in the Dashboard after the browser stops. API runs default to recording off, and Zero Data Retention projects never record.