---
title: "Get clip transcript"
method: GET
path: "/v1/videos/{id}/clips/{clipId}/transcript"
tags: ["Clips"]
---

# Get clip transcript

`GET /v1/videos/{id}/clips/{clipId}/transcript`

Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip's playback start. Word indices are stable identifiers for cut-by-transcript; they don't shift when cuts change.

## Path parameters

- `id` string, required — Video identifier
- `clipId` string, required — Clip identifier

## Response `200`

OK

- ClipTranscriptResponse — Clip transcript — what viewers hear.
  - `words` TranscriptWord[], required — Words on the playback timeline (cuts removed, times relative to the clip's playback start). Word indices are stable — they don't shift when cuts change; words inside cuts are simply absent.
    - `endTimeMs` number, required — Word end time, in ms on the clip's playback timeline
    - `hidden` boolean, required — Whether the word is hidden by an edit
    - `index` integer, required — Stable index of the word in the source recording
    - `startTimeMs` number, required — Word start time, in ms on the clip's playback timeline
    - `text` string, required — Word text

## Other responses

- `400` — The request was malformed or contained invalid parameters.
- `401` — Authentication is required. Provide a valid API key.
- `403` — You don't have permission to access this resource.
- `404` — The requested resource was not found.
- `429` — You have exceeded the rate limit. Please slow down.
- `500` — An unexpected error occurred
- `501` — The requested operation is not implemented.

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) · [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withchima/tella-public-api/revisions/cd69045c703a/schema)