Skip to main content
GET
Get clip transcript

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Video identifier

Example:

"vid_abc123def456"

clipId
string
required

Clip identifier

Example:

"cl_xyz789ghi012"

Query Parameters

startTimeMs
integer

Only return items at or after this time, in ms on the clip's playback timeline. Defaults to the clip's start.

Required range: 0 <= x <= 9007199254740991
Example:

60000

endTimeMs
integer

Only return items before this time (exclusive), in ms on the clip's playback timeline. Must be greater than startTimeMs. Defaults to the clip's end. Page through a long clip with windows that meet end to start.

Required range: 1 <= x <= 9007199254740991
Example:

120000

view
enum<string>

words (default): every word with its index, times and flags. sentences: one row per sentence (first and last word index, start and end time, text), about a quarter of the size, for reading the gist of a long clip. A time window cuts sentences at its edges.

Available options:
words,
sentences
Example:

"sentences"

Response

OK

Clip transcript — what viewers hear.

words
object[]
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.