Get a post’s video transcript

The captions X publishes for the video attached to a post, as one block of text plus time-coded segments. Read the coverage figure before you build on this: of 770 videos measured, 17.5% carried captions — but the average on its own misleads in both directions, so here is the spread. 41% of higher-engagement video has them, 27.5% of clips between one and three minutes, and 2.6% of clips under ten seconds. Some large accounts return nothing at all while others are near-complete, so sample the accounts you care about rather than budgeting off the average. It is not a generation delay — the same misses were re-probed 25 and 90 minutes later and were still empty — and it is not English-only: the languages X returned across the captioned set were en, pt, de, es, fr, en-US, tr, ar, he, ja, te, el, ru and it-IT. A video with no captions is a normal 200, not an error — a real one, for post 2094884934510956691, comes back as `"transcript": {"available": false, "originalLanguage": null, "durationSeconds": 191.8, "tracks": []}` with `pagesFetched: 0`. The duration is still filled in, so a miss still tells you the clip length. Do not retry it: the captions are not coming. When a transcript does exist, `tracks` holds exactly one entry — X does not translate, and none of the 770 videos declared more than one track. `transcript.originalLanguage` is inferred rather than declared, because X marks no track as the original: an auto-generated track anchors it, then the track X marks DEFAULT, then a sole track; with several uploader-supplied tracks and no DEFAULT it is null rather than a guess. Do not substitute the post’s own `lang` field for it — that describes the written text of the post and disagreed with the caption language in 28 of 92 measured cases. Billing: 1 credit.

curl -X POST "https://api.fetchlayer.dev/twitter/video-transcript" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"tweetId":"2070270274872738258"}'

import { FetchLayer } from '@fetchlayer/twitter';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.videoTranscript({
  "tweetId": "2070270274872738258"
});

{
  "pageTitle": "Twitter video transcript 2070270274872738258",
  "responseStatus": 200,
  "scrapedAt": "2026-09-16T19:13:57.396Z",
  "rawIncluded": false,
  "blocked": false,
  "resultType": "video-transcript",
  "pagesFetched": 1,
  "video": {
    "id": "2070270274872738258",
    "url": "https://x.com/i/status/2070270274872738258",
    "durationMs": 44372
  },
  "transcript": {
    "available": true,
    "originalLanguage": "en",
    "durationSeconds": 44.4,
    "tracks": [
      {
        "language": "en",
        "isOriginalLanguage": true,
        "isAutoGenerated": true,
        "source": "captions",
        "text": "In 1776, our founding fathers met in Philadelphia and changed the world forever.\nThe thing called the Declaration of Independence.\nTonight as we stand on the edge of our 250th year of independence\n…",
        "segments": [
          {
            "start": 0,
            "end": 6.419,
            "text": "In 1776, our founding fathers met in Philadelphia and changed the world forever."
          },
          {
            "start": 6.7,
            "end": 10.4,
            "text": "The thing called the Declaration of Independence."
          },
          {
            "start": 10.9,
            "end": 15.22,
            "text": "Tonight as we stand on the edge of our 250th year of independence"
          }
        ]
      }
    ]
  },
  "raw": null
}

{
  "error": "Invalid API key"
}