Live preview & recording

Watch the agent’s browser live, embed it in your app, and get an MP4 recording after the run.

Every run’s browser can be watched live and is recorded. Both the live view and the recording live on the browser the run used — you get the browserId from the run, then read them off the browser.

Watch a run live

Start a run, get its browserId from GET /runs/{id} (it appears once the browser is provisioned), then read the browser’s liveViewUrl.

Python

from browser_use import BrowserUse

client = BrowserUse()
run = client.agents.browser_use.runs.create(task="Check how many GitHub stars browser-use has")

# browser_id appears on the run once provisioned
run = client.agents.browser_use.runs.get(run.id)
browser = client.browsers.get(run.browser_id)
print(browser.live_view_url)   # open this to watch live

# 1. get the run → browserId (null until provisioned)
curl "https://api.browser-use.com/api/v1/agents/browser-use/runs/RUN_ID" \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY"
# → { "browserId": "br_123", ... }

# 2. the browser carries the live view url
curl "https://api.browser-use.com/api/v1/browsers/br_123" \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY"
# → { "liveViewUrl": "https://live.browser-use.com?wss=...", ... }

A standalone browser returns liveViewUrl immediately on POST /browsers (it’s provisioned synchronously).

Embed it in your app

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

The live view is hosted on live.browser-use.com. If your app sets a Content Security Policy, allow it in frame-src:

Content-Security-Policy: frame-src 'self' https://live.browser-use.com;

Customize with query params on the URL: ?theme=light (default dark), ?ui=false (hide browser chrome).

Recording

Every browser records automatically. Fetch a fresh, expiring MP4 URL on demand from the browser — no flag to enable.

Python

rec = client.browsers.recording(run.browser_id)
print(rec.url)   # presigned MP4

curl "https://api.browser-use.com/api/v1/browsers/BROWSER_ID/recording" \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY"
# → { "url": "https://.../recording.mp4?..." }

To find the BROWSER_ID for a run, read browserId off GET /runs/{id} (as above). See Manage a browser for the full browser API.

Recording URLs are presigned and expire after 1 hour. Download or serve the MP4 promptly; save it to your own storage if you need it later. A run that never opened a browser has no recording.