---
title: "Get a recording frame image URL"
method: GET
path: "/recordings/{public_id}/frame"
tags: ["REST API"]
---

# Get a recording frame image URL

`GET /recordings/{public_id}/frame`

## Request

- Base URL: `https://api.supercut.ai/v1`
- URL: `https://api.supercut.ai/v1/recordings/{public_id}/frame`
- Auth: HTTP bearer

Works with: Personal token Workspace token

Returns a signed URL for a video frame at the requested timestamp. Defaults to the composed \`screen\_and\_camera\` frame; pass \`source\` to read the screen or camera track on its own. Requesting a source the recording does not have returns a 404 listing the ones it does. If the recording is still processing, returns the public processing status instead.

## Path parameters

- `public_id` string, required

## Query parameters

- `time_ms` number
- `time` number
- `quality` 'uhd' | 'qhd' | 'fhd' | 'hd' | 'sd'
- `source` 'screen' | 'camera' | 'screen_and_camera'

## Response `200`

200

- union
  - object
    - `data` object, required
      - `public_id` string, required
      - `status` 'completed', required
      - `url` string, required
  - object
    - `data` object, required
      - `public_id` string, required
      - `status` 'pending' | 'processing' | 'failed', required

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `403`: 403
- `404`: 404
- `409`: 409
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/supercut/apis/supercut-platform-api.md) · [All operations](https://skmtc.dev/supercut/apis/supercut-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/supercut/apis/supercut-platform-api/revisions/66033895a858?raw)