Recordings: HTML and URLs to Video and GIF
You can now turn HTML/CSS or any URL into a video or GIF. Send the same HTML or URL you’d use for an image, choose how long to record, and get back a recording_url you can embed in your app, website, or email, or request directly.
{ "url": "https://example.com", "duration_ms": 6000, "output": { "format": "mp4" }, "actions": [{ "type": "simple_scroll" }]}- MP4, WebM, and GIF output. Set the format, frame rate, and scale with
output. - Actions. Scroll, click, pause, and run JavaScript during the recording with optional
actions, with easing for smooth movement. - Start at the right moment. Use a
triggerto wait for an element to appear or for your page to callwindow.RecordingReady(), so loading spinners stay out of the video. - Flexible length. Record for a fixed time, or let
duration_modefit the video to your actions. - Works with what you already use. Recordings support viewport settings, proxies, cookie banner blocking, storage destinations, and the
dldownload parameter. - Manage and automate. List, retrieve, store, and delete recordings with the Management API. You can optionally check a recording’s status for workflows, and subscribe to
recording_stored,recording_failed, andrecording_deletedwebhook events. - MCP tools. Agents can create and manage recordings with the new recording tools.
Recordings are available on the Startup plan (10,000 images/month) and higher. A recording uses 2 credits for its first 5 seconds and 1 credit for each additional 5 seconds. See Credits for how duration modes affect usage, with worked examples.
Get started with the Recordings overview, or follow a guide for scrolling videos, animated HTML, or interactions.