---
title: "Search recordings"
method: GET
path: "/recordings/search"
tags: ["REST API"]
---

# Search recordings

`GET /recordings/search`

## Request

- Base URL: `https://api.supercut.ai/v1`
- URL: `https://api.supercut.ai/v1/recordings/search`
- Auth: HTTP bearer

Works with: Personal token

Search recordings in the personal-token caller's workspace by meaning or keyword. Matches recording titles and AI summaries and returns only the recordings the caller can see, best match first. An empty results page with a non-null next\_cursor is not the end: keep paging with the cursor.

## Query parameters

- `q` string, required
- `cursor` string
- `limit` integer

## Response `200`

200

- object
  - `data` object, required
    - `results` object[], required
      - `public_id` string, required
      - `link` string, required: The recording's page: on the workspace's custom domain when it has one, else on the Supercut app that served the response.
      - `title` string, required
      - `created_at` string, required
      - `duration_ms` number, nullable, required
      - `snippet` string, nullable, required
    - `workspace_safename` string, required
    - `next_cursor` string, nullable, 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)