Transcript object

7 endpoints on 7 platforms return the Transcript object with the same 6 fields, so code written for one platform reads the others unchanged. A call costs $0.0020.

Stable object · Updated 2026-10-17Open in ChatGPTOpen in Claude

A Transcript is what is said in a video, as text. TikTok, YouTube and Reddit also give it in timed segments, each with its start and end in seconds; the others give one text.

It has no ID of its own: post_id names the post it belongs to, the same ID the post endpoints take. A Meta Ad Library video belongs to an ad, and there post_id is the ad's library ID.

Fields

A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.

post_id text

ID of the post it belongs to

lang text

Language code

text text

The whole text

segments list of object standard

Timed segments

segments[].start number standard

Start, in seconds

segments[].end number standard

End, in seconds

segments[].text text standard

Text of the segment

Where each number comes from

The same field name does not always mean the same act on every platform. This table says which of the platform's own numbers goes into the field.

FieldWhat it holds thereOn
post_idLibrary ID of the ad it belongs toMeta Ad Library
langThe language of the captions file readReddit

What a platform cannot give

A platform stands against a field when none of its endpoints gives it.

FieldNot available on
langTikTokInstagramX (Twitter)LinkedInMeta Ad Library
segments[].startInstagramX (Twitter)LinkedInMeta Ad Library
segments[].endInstagramX (Twitter)LinkedInMeta Ad Library
segments[].textInstagramX (Twitter)LinkedInMeta Ad Library
One endpoint may still leave out a field another gives: each endpoint's page lists what it cannot give, and every answer says so in meta.unavailable.

Endpoints that return Transcript

The number beside each platform is how many of its endpoints return it.

EndpointPathPrice
TikTok video transcriptGET/v1/tiktok/videos/transcript/get$0.0020
YouTube video transcriptGET/v1/youtube/videos/transcript/get$0.0020
Instagram video transcriptGET/v1/instagram/posts/transcript/get$0.0020
X video transcriptGET/v1/x/posts/transcript/get$0.0020
Reddit video transcriptGET/v1/reddit/posts/transcript/get$0.0020
LinkedIn video transcriptGET/v1/linkedin/posts/transcript/get$0.0020
Meta ad video transcriptGET/v1/meta/ads/transcript/get$0.0020

Example

One item from tiktok.videos.transcript.get, as recorded 2026-10-12 18:47 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Transcript · tiktok.videos.transcript.get
{
  "post_id": "7735791757913201402",
  "text": "Hey everyone, today I am going through what I packed for weekend hiking. Short version: light, fits in one bag, hard to break. Let's go piece by piece.",
  "segments": [
    {
      "start": 1.14,
      "end": 2.76,
      "text": "Hey everyone, today I am going through what I packed for weekend hiking."
    },
    {
      "start": 3.06,
      "end": 4.98,
      "text": "Short version: light, fits in one bag, hard to break."
    },
    // … 35 more
  ]
}

The whole response is on the endpoint's page →

Related

Other objects