Help centre

Using the API

The response format: text, segments and timestamps

What comes back from a successful fetch, and how to use the segment timings.

Every successful response uses the same envelope, whatever the platform:

json
{
  "ok": true,
  "request_id": "req_…",
  "data": {},
  "usage": { "credits_spent": 1 }
}

The data block

For a transcript, data carries kind, video_id, platform, title, the full text, and segments.

Segments

Each segment has start, duration and text, all in seconds. That is what makes the output useful for subtitles, clipping, and citing the exact second a claim was made rather than quoting a wall of text.

Send "timestamps": "none" to omit the segments array when you only need the words. The default is "segment".

request_id

Quote it if you contact support. It identifies the exact call in our logs.

The same envelope comes back for every platform, which is the point of using one transcript API rather than four integrations.

More in Using the API

Still stuck?

Open the chat launcher, bottom right, and include your request_id if you have one. Or email [email protected].

The response format: text, segments and timestamps · TranscriptFetch Help