Search APIs
Loading…
← API Store
Social

X (Twitter)

X (Twitter)

X video transcript

GET /twitter/v1/tweet/transcript
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
urlrequiredstring Example: https://x.com/NASA/status/2111180963661435219

Every endpoint also takes: raw、fields、fresh、output、records

{
  "author": "NASA",
  "author_name": "NASA",
  "cached": false,
  "created_at": "2026-10-16T19:42:20.000Z",
  "credits_used": 1,
  "duration_ms": 17751,
  "duration_s": 17.8133125,
  "id": "2111180963661435219",
  "language": "en",
  "likes": 1684,
  "model": "@cf/openai/whisper-large-v3-turbo",
  "poster": "https://pbs.twimg.com/amplify_video_thumb/2111180787802370048/img/0nbyTdS0MRg5JqXk.jpg",
  "replies": 192,
  "segments": [],
  "source": "ai",
  "text": "",
  "tweet": {
    "__typename": "Tweet",
    "conversation_count": 192,
    "created_at": "2026-10-16T19:42:20.000Z",
    "display_text_range": [
      0,
      264
    ],
    "edit_control": {
      "edit_tweet_ids": [
        "2111180963661435219"
      ],
      "editable_until_msecs": "1792183340000",
      "edits_remaining": "5",
      "is_edit_eligible": true
    },
    "entities": {
      "media": [
        {
          "display_url": "pic.x.com/pXYGxy6ZbE",
          "expanded_url": "https://x.com/NASA/status/2111180963661435219/video/1",
          "indices": [
            265,
            288
          ],
          "url": "https://t.co/pXYGxy6ZbE"
        }
      ],
      "urls": [
        {
          "display_url": "nasa.gov/maxpower/",
          "expanded_url": "https://www.nasa.gov/maxpower/",
          "indices": [
            241,
            264
          ],
          "url": "https://t.co/SPHni2YCxO"
        }
      ],
      "user_mentions": [
        {
          "id_str": "16580226",
          "indices": [
            104,
            116
          ],
          "name": "NASA's Kennedy Space Center",
          "screen_name": "NASAKennedy"
        }
      ]
    },
    "favorite_count": 1684,
    "id_str": "2111180963661435219",
    "isEdited": false,
    "isStaleEdit": false,
    "lang": "en",
    "mediaDetails": [
      {
        "additional_media_info": {},
        "display_url": "pic.x.com/pXYGxy6ZbE",
        "expanded_url": "https://x.com/NASA/status/2111180963661435219/video/1",
        "ext_media_availability": {
          "status": "Available"
        },
        "indices": [
          265,
          288
        ],
        "media_url_https": "https://pbs.twimg.com/amplify_video_thumb/2111180787802370048/img/0nbyTdS0MRg5JqXk.jpg",
        "original_info": {
          "focus_rects": [],
          "height": 1920,
          "width": 1080
        },
        "sizes": {
          "large": {
            "…": "3 fields"
          },
          "medium": {
            "…": "3 fields"
          },
          "small": {
            "…": "3 fields"
          },
          "thumb": {
            "…": "3 fields"
          }
        },
        "type": "video",
        "url": "https://t.co/pXYGxy6ZbE",
        "video_info": {
          "aspect_ratio": [
            9,
            16
          ],
          "duration_millis": 17751,
          "variants": [
            {
              "…": "2 fields"
            },
            {
              "…": "3 fields"
            },
            "… 3 more"
          ]
        }
      }
    ],
    "news_action_type": "conversation",
    "photos": [],
    "possibly_sensitive": false,
    "text": "The aircraft lineup just keeps getting bigger. ✈️\n\nMAX POWER, a new aerospace expo, is set for Nov. 7-8 @NASAKennedy — featuring flyovers an…",
    "user": {
      "id_str": "11348282",
      "is_blue_verified": true,
      "name": "NASA",
      "profile_image_shape": "Square",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg",
      "screen_name": "NASA",
      "verified": false,
      "verified_type": "Government"
    },
    "video": {
      "aspectRatio": [
        9,
        16
      ],
      "contentType": "media_entity",
      "durationMs": 17751,
      "mediaAvailability": {
        "status": "available"
      },
      "poster": "https://pbs.twimg.com/amplify_video_thumb/2111180787802370048/img/0nbyTdS0MRg5JqXk.jpg",
      "variants": [
        {
          "src": "https://video.twimg.com/amplify_video/2111180787802370048/pl/HWvzEhcDZtXVLLp5.m3u8?v=aac",
          "type": "application/x-mpegURL"
        },
        {
          "src": "https://video.twimg.com/amplify_video/2111180787802370048/vid/avc1/320x568/ARyMrUiwUNJCT_91.mp4",
          "type": "video/mp4"
        },
        "… 3 more"
      ],
      "videoId": {
        "id": "2111180963661435219",
        "type": "tweet"
      },
      "viewCount": 0
    }
  },
  "tweet_text": "The aircraft lineup just keeps getting bigger. ✈️\n\nMAX POWER, a new aerospace expo, is set for Nov. 7-8 @NASAKennedy — featuring flyovers an…",
  "url": "https://x.com/i/status/2111180963661435219",
  "video": "https://video.twimg.com/amplify_video/2111180787802370048/vid/avc1/320x568/ARyMrUiwUNJCT_91.mp4",
  "video_variants": [
    {
      "bitrate": null,
      "content_type": "application/x-mpegURL",
      "url": "https://video.twimg.com/amplify_video/2111180787802370048/pl/HWvzEhcDZtXVLLp5.m3u8?v=aac"
    },
    {
      "bitrate": 632000,
      "content_type": "video/mp4",
      "url": "https://video.twimg.com/amplify_video/2111180787802370048/vid/avc1/320x568/ARyMrUiwUNJCT_91.mp4"
    },
    "… 3 more"
  ]
}
Response fields (125)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.authorstring
$.author_namestring
$.cachedboolean
$.created_atstring
$.credits_usedinteger
$.duration_msinteger
$.duration_snumber
$.idstring
$.languagestring
$.likesinteger
$.modelstring
$.posterstring
$.repliesinteger
$.segmentsarray
$.sourcestring
$.textstring
$.tweetobject
$.tweet.__typenamestring
$.tweet.conversation_countinteger
$.tweet.created_atstring
$.tweet.display_text_rangearray
$.tweet.display_text_range[]integer
$.tweet.edit_controlobject
$.tweet.edit_control.edit_tweet_idsarray
$.tweet.edit_control.edit_tweet_ids[]string
$.tweet.edit_control.editable_until_msecsstring
$.tweet.edit_control.edits_remainingstring
$.tweet.edit_control.is_edit_eligibleboolean
$.tweet.entitiesobject
$.tweet.entities.mediaarray
$.tweet.entities.media[]object
$.tweet.entities.media[].display_urlstring
$.tweet.entities.media[].expanded_urlstring
$.tweet.entities.media[].indicesarray
$.tweet.entities.media[].indices[]integer
$.tweet.entities.media[].urlstring
$.tweet.entities.urlsarray
$.tweet.entities.urls[]object
$.tweet.entities.urls[].display_urlstring
$.tweet.entities.urls[].expanded_urlstring
$.tweet.entities.urls[].indicesarray
$.tweet.entities.urls[].indices[]integer
$.tweet.entities.urls[].urlstring
$.tweet.entities.user_mentionsarray
$.tweet.entities.user_mentions[]object
$.tweet.entities.user_mentions[].id_strstring
$.tweet.entities.user_mentions[].indicesarray
$.tweet.entities.user_mentions[].indices[]integer
$.tweet.entities.user_mentions[].namestring
$.tweet.entities.user_mentions[].screen_namestring
$.tweet.favorite_countinteger
$.tweet.id_strstring
$.tweet.isEditedboolean
$.tweet.isStaleEditboolean
$.tweet.langstring
$.tweet.mediaDetailsarray
$.tweet.mediaDetails[]object
$.tweet.mediaDetails[].additional_media_infoobject
$.tweet.mediaDetails[].display_urlstring
$.tweet.mediaDetails[].expanded_urlstring
$.tweet.mediaDetails[].ext_media_availabilityobject
$.tweet.mediaDetails[].ext_media_availability.statusstring
$.tweet.mediaDetails[].indicesarray
$.tweet.mediaDetails[].indices[]integer
$.tweet.mediaDetails[].media_url_httpsstring
$.tweet.mediaDetails[].original_infoobject
$.tweet.mediaDetails[].original_info.focus_rectsarray
$.tweet.mediaDetails[].original_info.heightinteger
$.tweet.mediaDetails[].original_info.widthinteger
$.tweet.mediaDetails[].sizesobject
$.tweet.mediaDetails[].sizes.largeobject
$.tweet.mediaDetails[].sizes.large.…string
$.tweet.mediaDetails[].sizes.mediumobject
$.tweet.mediaDetails[].sizes.medium.…string
$.tweet.mediaDetails[].sizes.smallobject
$.tweet.mediaDetails[].sizes.small.…string
$.tweet.mediaDetails[].sizes.thumbobject
$.tweet.mediaDetails[].sizes.thumb.…string
$.tweet.mediaDetails[].typestring
$.tweet.mediaDetails[].urlstring
$.tweet.mediaDetails[].video_infoobject
$.tweet.mediaDetails[].video_info.aspect_ratioarray
$.tweet.mediaDetails[].video_info.aspect_ratio[]integer
$.tweet.mediaDetails[].video_info.duration_millisinteger
$.tweet.mediaDetails[].video_info.variantsarray
$.tweet.mediaDetails[].video_info.variants[]object | string
$.tweet.mediaDetails[].video_info.variants[].…string
$.tweet.news_action_typestring
$.tweet.photosarray
$.tweet.possibly_sensitiveboolean
$.tweet.textstring
$.tweet.userobject
$.tweet.user.id_strstring
$.tweet.user.is_blue_verifiedboolean
$.tweet.user.namestring
$.tweet.user.profile_image_shapestring
$.tweet.user.profile_image_url_httpsstring
$.tweet.user.screen_namestring
$.tweet.user.verifiedboolean
$.tweet.user.verified_typestring
$.tweet.videoobject
$.tweet.video.aspectRatioarray
$.tweet.video.aspectRatio[]integer
$.tweet.video.contentTypestring
$.tweet.video.durationMsinteger
$.tweet.video.mediaAvailabilityobject
$.tweet.video.mediaAvailability.statusstring
$.tweet.video.posterstring
$.tweet.video.variantsarray
$.tweet.video.variants[]object | string
$.tweet.video.variants[].srcstring
$.tweet.video.variants[].typestring
$.tweet.video.videoIdobject
$.tweet.video.videoId.idstring
$.tweet.video.videoId.typestring
$.tweet.video.viewCountinteger
$.tweet_textstring
$.urlstring
$.videostring
$.video_variantsarray
$.video_variants[]object | string
$.video_variants[].bitrateinteger | null
$.video_variants[].content_typestring
$.video_variants[].urlstring