---
title: "Record Video"
method: POST
path: "/v1/video"
tags: ["Video"]
---

# Record Video

`POST /v1/video`

Record a video of a webpage with optional scrolling. Supports WebM, MP4, and GIF output. Costs 5 credits per recording.

## Request body

- VideoRequest
  - `url` string, uri, required
  - `format` 'webm' | 'mp4' | 'gif'
  - `width` integer
  - `height` integer
  - `duration` integer — Duration in seconds
  - `fps` integer
  - `scrolling` boolean
  - `scrollSpeed` integer
  - `darkMode` boolean
  - `blockAds` boolean
  - `blockCookieBanners` boolean
  - `delay` integer
  - `responseType` 'binary' | 'base64' | 'json'

## Response `200`

Video recorded

- object
  - `success` boolean
  - `data` string
  - `format` string
  - `width` integer
  - `height` integer
  - `duration` integer
  - `fileSize` integer
  - `took` integer

## Other responses

- `400` — Validation error
- `429` — Quota exceeded
- `503` — Server busy (max concurrent videos reached)

---

[API](https://skmtc.net/snapapi/apis/snapapi-screenshot-web-data-api.md) · [All operations](https://skmtc.net/snapapi/apis/snapapi-screenshot-web-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snapapi/snapapi-screenshot-web-data-api/versions/b12ff2791613/schema)