---
title: "List UGC reaction clips"
method: GET
path: "/ugc/reactions"
tags: ["UGC"]
---

# List UGC reaction clips

`GET /ugc/reactions`

Returns short clips of a person reacting to camera, split into `system` (the built-in library) and `custom` (reactions you generated). Pick one by `id` and use it as `reactionId` in `POST /ugc/videos` to build a finished UGC hook video. The name and tags describe the person and the reaction, so you can choose one that fits your hook. For your own reactions, check `status` (`pending`, `processing`, `completed`, or `failed`); built-in reactions are always ready.

## Response `200`

OK

- object
  - `system` object[], required — Built-in reaction clips shared across all orgs.
    - `id` string, uuid, required — Reaction clip ID. Use as `reactionId` in POST /ugc/videos.
    - `name` string, required — Describes the person and reaction, e.g. "A woman in living room giving a mild shock reaction".
    - `description` string, nullable, required — Optional longer description of the clip.
    - `thumbnailUrl` string, nullable, required — Preview thumbnail URL, when available.
    - `durationSeconds` number, required — Clip length in seconds.
    - `tags` string[], required — Keywords for the reaction (mood, setting, gender).
    - `status` string, required — Built-in reactions are always `completed`.
    - `videoUrl` string, required — The clip URL.
  - `custom` object[], required — Reactions this org generated.
    - `id` string, uuid, required — Reaction clip ID. Use as `reactionId` in POST /ugc/videos.
    - `name` string, required
    - `description` string, nullable, required
    - `thumbnailUrl` string, nullable, required
    - `durationSeconds` number, required
    - `tags` string[], required
    - `status` string, required — `pending`, `processing`, `completed`, or `failed`. Only `completed` clips are usable.
    - `videoUrl` string, required — The clip URL (a placeholder until the reaction finishes generating).

## Other responses

- `401` — 401
- `402` — 402
- `403` — 403

---

[API](https://skmtc.net/aituber/apis/aituber-api.md) · [All operations](https://skmtc.net/aituber/apis/aituber-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aituber/aituber-api/revisions/35448566f143/schema)