# RecordHTML

> RecordHTML records HTML5 ads, banners, animations and web pages to MP4, WebM or GIF in a real browser: from its web app, a REST API or an MCP server.

- REST API: base URL `https://api.recordhtml.com/v1`, with an API key in the `x-api-key` header (create one at [API settings](https://recordhtml.com/settings/api)).
- Flow: `POST /v1/jobs` with `{ "url", "width", "height", "durationSec" }`, poll `GET /v1/jobs/{id}` until `status` is `ready`, then `GET /v1/jobs/{id}/video` downloads the file.
- MCP server, for chat assistants: `https://mcp.recordhtml.com` (Streamable HTTP, sign in with OAuth).
- A creative can mark the clip with `trim_start()` and `trim_end()`, which the recorder defines in every frame.

## Docs

- [API reference](https://recordhtml.com/docs/api.md): endpoints, the recording request, trim markers, the job, errors, limits and webhooks
- [MCP server](https://recordhtml.com/docs/mcp.md): connecting Claude, ChatGPT, Codex, Cursor and VS Code, and the five tools

## Optional

- [How to Convert an HTML5 Banner to MP4](https://recordhtml.com/guides/html5-banner-to-mp4): Export a Google Web Designer or Adobe Animate HTML5 banner, prepare its ZIP or hosted URL, and record an MP4 with the right size and timing.
- [Record GSAP and CSS Animations as Video](https://recordhtml.com/guides/gsap-css-animation-to-video): Understand real-time and frame-by-frame browser recording, prepare GSAP or CSS animations, and choose timing and export settings.
- [Backup GIFs for HTML5 Banners: Sizes and Limits](https://recordhtml.com/guides/html5-backup-gif): Plan backup GIFs for HTML5 banners, check ad-network animation and file-size limits, and reduce output size without guessing compliance.
- [DOOH Video Specs: Resolution, Frame Rate and Codec](https://recordhtml.com/guides/dooh-video-specs): Build a DOOH delivery checklist covering native screen dimensions, codecs, bitrate, duration and frame rates, including 4416×1656 at 29.97 fps.
- [Puppeteer vs Playwright vs timecut vs RecordHTML](https://recordhtml.com/guides/browser-recording-tools): Compare browser automation, screencasting and frame-stepped recording workflows, including setup, timing, audio and delivery responsibilities.
- [html5animationtogif.com Alternative: RecordHTML](https://recordhtml.com/guides/html5animationtogif-alternative): A practical comparison of HTML5 animation export workflows, with capability checks for GIF, MP4, dimensions, audio, uploads and timing.
- [All the docs in one file](https://recordhtml.com/llms-full.txt)