← API Store
Social
X (Twitter)
X (Twitter)
X video transcript
GET /twitter/v1/tweet/transcriptEvery 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
| Name | Type | Description |
|---|---|---|
urlrequired | string | 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 |
$.author | string |
$.author_name | string |
$.cached | boolean |
$.created_at | string |
$.credits_used | integer |
$.duration_ms | integer |
$.duration_s | number |
$.id | string |
$.language | string |
$.likes | integer |
$.model | string |
$.poster | string |
$.replies | integer |
$.segments | array |
$.source | string |
$.text | string |
$.tweet | object |
$.tweet.__typename | string |
$.tweet.conversation_count | integer |
$.tweet.created_at | string |
$.tweet.display_text_range | array |
$.tweet.display_text_range[] | integer |
$.tweet.edit_control | object |
$.tweet.edit_control.edit_tweet_ids | array |
$.tweet.edit_control.edit_tweet_ids[] | string |
$.tweet.edit_control.editable_until_msecs | string |
$.tweet.edit_control.edits_remaining | string |
$.tweet.edit_control.is_edit_eligible | boolean |
$.tweet.entities | object |
$.tweet.entities.media | array |
$.tweet.entities.media[] | object |
$.tweet.entities.media[].display_url | string |
$.tweet.entities.media[].expanded_url | string |
$.tweet.entities.media[].indices | array |
$.tweet.entities.media[].indices[] | integer |
$.tweet.entities.media[].url | string |
$.tweet.entities.urls | array |
$.tweet.entities.urls[] | object |
$.tweet.entities.urls[].display_url | string |
$.tweet.entities.urls[].expanded_url | string |
$.tweet.entities.urls[].indices | array |
$.tweet.entities.urls[].indices[] | integer |
$.tweet.entities.urls[].url | string |
$.tweet.entities.user_mentions | array |
$.tweet.entities.user_mentions[] | object |
$.tweet.entities.user_mentions[].id_str | string |
$.tweet.entities.user_mentions[].indices | array |
$.tweet.entities.user_mentions[].indices[] | integer |
$.tweet.entities.user_mentions[].name | string |
$.tweet.entities.user_mentions[].screen_name | string |
$.tweet.favorite_count | integer |
$.tweet.id_str | string |
$.tweet.isEdited | boolean |
$.tweet.isStaleEdit | boolean |
$.tweet.lang | string |
$.tweet.mediaDetails | array |
$.tweet.mediaDetails[] | object |
$.tweet.mediaDetails[].additional_media_info | object |
$.tweet.mediaDetails[].display_url | string |
$.tweet.mediaDetails[].expanded_url | string |
$.tweet.mediaDetails[].ext_media_availability | object |
$.tweet.mediaDetails[].ext_media_availability.status | string |
$.tweet.mediaDetails[].indices | array |
$.tweet.mediaDetails[].indices[] | integer |
$.tweet.mediaDetails[].media_url_https | string |
$.tweet.mediaDetails[].original_info | object |
$.tweet.mediaDetails[].original_info.focus_rects | array |
$.tweet.mediaDetails[].original_info.height | integer |
$.tweet.mediaDetails[].original_info.width | integer |
$.tweet.mediaDetails[].sizes | object |
$.tweet.mediaDetails[].sizes.large | object |
$.tweet.mediaDetails[].sizes.large.… | string |
$.tweet.mediaDetails[].sizes.medium | object |
$.tweet.mediaDetails[].sizes.medium.… | string |
$.tweet.mediaDetails[].sizes.small | object |
$.tweet.mediaDetails[].sizes.small.… | string |
$.tweet.mediaDetails[].sizes.thumb | object |
$.tweet.mediaDetails[].sizes.thumb.… | string |
$.tweet.mediaDetails[].type | string |
$.tweet.mediaDetails[].url | string |
$.tweet.mediaDetails[].video_info | object |
$.tweet.mediaDetails[].video_info.aspect_ratio | array |
$.tweet.mediaDetails[].video_info.aspect_ratio[] | integer |
$.tweet.mediaDetails[].video_info.duration_millis | integer |
$.tweet.mediaDetails[].video_info.variants | array |
$.tweet.mediaDetails[].video_info.variants[] | object | string |
$.tweet.mediaDetails[].video_info.variants[].… | string |
$.tweet.news_action_type | string |
$.tweet.photos | array |
$.tweet.possibly_sensitive | boolean |
$.tweet.text | string |
$.tweet.user | object |
$.tweet.user.id_str | string |
$.tweet.user.is_blue_verified | boolean |
$.tweet.user.name | string |
$.tweet.user.profile_image_shape | string |
$.tweet.user.profile_image_url_https | string |
$.tweet.user.screen_name | string |
$.tweet.user.verified | boolean |
$.tweet.user.verified_type | string |
$.tweet.video | object |
$.tweet.video.aspectRatio | array |
$.tweet.video.aspectRatio[] | integer |
$.tweet.video.contentType | string |
$.tweet.video.durationMs | integer |
$.tweet.video.mediaAvailability | object |
$.tweet.video.mediaAvailability.status | string |
$.tweet.video.poster | string |
$.tweet.video.variants | array |
$.tweet.video.variants[] | object | string |
$.tweet.video.variants[].src | string |
$.tweet.video.variants[].type | string |
$.tweet.video.videoId | object |
$.tweet.video.videoId.id | string |
$.tweet.video.videoId.type | string |
$.tweet.video.viewCount | integer |
$.tweet_text | string |
$.url | string |
$.video | string |
$.video_variants | array |
$.video_variants[] | object | string |
$.video_variants[].bitrate | integer | null |
$.video_variants[].content_type | string |
$.video_variants[].url | string |