← API Store
Social
TikTok
TikTok
TikTok video transcript (TikTok captions)
GET /tiktok/v1/video/transcriptEvery response includes credits_used: the credits this call cost.
TikTok's own captions (WebVTT): auto-generated (ASR) or uploaded tracks, read from the video page. languages lists every track; language picks one (default en).
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://www.tiktok.com/@x/video/7688809734673108237 |
language | string | Example: en |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"credits_used": 1,
"language": "eng-US",
"languages": [
"eng-US"
],
"segments": [
{
"end": 10.56,
"start": 4.58,
"text": "perfect my soul is shining just like yours ingredients"
},
{
"end": 16.88,
"start": 12.3,
"text": "we're Browning the sausage smoking it with white wine"
},
"… 11 more"
],
"source": "auto",
"subtitles": [
{
"Format": "webvtt",
"LanguageCodeName": "eng-US",
"LanguageID": "2",
"Size": 961,
"Source": "ASR",
"Url": "https://v16m-webapp.tiktokcdn-us.com/eb8fb3c74bcb45291a2dc462ecf66a4f/6ade5cfa/video/tos/useast5/tos-useast5-v-0068-tx/468665e21e0342a29b796…",
"UrlExpire": 1792957690,
"Version": "1:big_caption"
}
],
"text": "perfect my soul is shining just like yours ingredients we're Browning the sausage smoking it with white wine Mamma Mia pasta water is boilin…",
"video": {
"ai_generated": null,
"author": {
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/c96b3082943eef716b9eede3e8448266~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=…",
"id": "6767173591098770437",
"nickname": "The Pasta Queen",
"username": "the_pastaqueen",
"verified": true
},
"author_info": {
"avatar_medium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/c96b3082943eef716b9eede3e8448266~tplv-tiktokx-cropcenter:720:720.jpeg?dr=96…",
"avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/c96b3082943eef716b9eede3e8448266~tplv-tiktokx-cropcenter:100:100.jpeg?dr=96…",
"private": false,
"sec_uid": "MS4wLjABAAAAceXmnQq1ZMnEb0ia8g_K-8qs52cLk8n5bQJER0q-Vrot7KXFisgFujMJSX0Yr-Iq",
"signature": "Pasta. Periodt. 🫦",
"url": "https://www.tiktok.com/@the_pastaqueen"
},
"author_stats": {
"diggCount": "4304",
"followerCount": "4700000",
"followingCount": "392",
"friendCount": "0",
"heart": "91000000",
"heartCount": "91000000",
"videoCount": "1676"
},
"challenges": [],
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oQejGIADIIVDyOI8QC0w6kLafa4lIHeEZiAJZZ~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"create_time": "2026-09-23T19:08:50.000Z",
"create_time_unix": 1790190530,
"desc": "Let’s kick off fall with this creamy Parmesan and sausage pasta that my daughter Eleonora absolutely loves! As always, to get this recipe a…",
"diversification_labels": null,
"duet_enabled": true,
"duration": 85,
"hashtags": [],
"id": "7688809734673108237",
"images": [],
"is_ad": false,
"location_created": null,
"mentions": [],
"music": {
"author": "xvmlkx",
"id": "7668176404089047839",
"title": "original sound"
},
"music_info": {
"album": null,
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/023fa83035accc5931ce78c3ee75b4b4~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"duration": 102,
"original": true,
"play_url": "https://v16m.tiktokcdn-us.com/611541dbbf1b54007cf4c0744255c500/6adc0e6b/video/tos/useast8/tos-useast8-v-27dcd7-tx2/o0IVIAEAJq3aC0DqLFDofBDtc…"
},
"pinned": null,
"poi": null,
"private_item": false,
"share_enabled": true,
"stats": {
"collectCount": "1064",
"commentCount": "127",
"diggCount": "11900",
"playCount": "131900",
"repostCount": "0",
"shareCount": "271"
},
"stitch_enabled": true,
"suggested_words": [
"Creamy Pasta",
"pasta",
"… 8 more"
],
"url": "https://www.tiktok.com/@the_pastaqueen/video/7688809734673108237",
"video": {
"bitrate": 1547744,
"bitrates": [
{
"bitrate": 1558489,
"codec": "h265_hvc1",
"gear": "adapt_lowest_1080_1",
"height": 1920,
"quality": 2,
"size": 16741681,
"urls": [
"https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c004-tx/o0ZEelAbHQ7VRfeVAwA4RUgo8ZIttCHk1MyjaW/?a=1988&bti=ODszN…",
"https://v19-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c004-tx/o0ZEelAbHQ7VRfeVAwA4RUgo8ZIttCHk1MyjaW/?a=1988&bti=ODszN…",
"… 1 more"
],
"width": 1080
},
{
"bitrate": 1547744,
"codec": "h264",
"gear": "normal_720_0",
"height": 1280,
"quality": 10,
"size": 16625874,
"urls": [
"https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c002-tx/ooaAwCQEfoMfjUA1ZRtlWAoH8ykAlVRIRHgZes/?a=1988&bti=ODszN…",
"https://v19-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c002-tx/ooaAwCQEfoMfjUA1ZRtlWAoH8ykAlVRIRHgZes/?a=1988&bti=ODszN…",
"… 1 more"
],
"width": 720
},
"… 2 more"
],
"codec": "h264",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oQejGIADIIVDyOI8QC0w6kLafa4lIHeEZiAJZZ~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"definition": "720p",
"download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/oAeEsGaxIAkZI6gIZHRIzyZdlQ1jAmLDVoCf4e/?a=1988&bti=ODszNWYu…",
"dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oY48CBSd0rPh5jVabRIUcAiIQPgEIRL2ciCTB~tplv-tiktokx-origin.image?dr=9636&x-exp…",
"format": "mp4",
"height": 1280,
"origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/okeIDIy8QIZIkAaC60OGeH4jZZALD2EAGc4VQf~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c002-tx/ooaAwCQEfoMfjUA1ZRtlWAoH8ykAlVRIRHgZes/?a=1988&bti=ODszN…",
"quality": "normal",
"ratio": "720p",
"size": 16625874,
"subtitles": [
{
"format": "webvtt",
"language": "eng-US",
"source": "ASR",
"url": "https://v16m-webapp.tiktokcdn-us.com/eb8fb3c74bcb45291a2dc462ecf66a4f/6ade5cfa/video/tos/useast5/tos-useast5-v-0068-tx/468665e21e0342a29b796…"
}
],
"width": 720
}
},
"video_id": "7688809734673108237"
} Response fields (118)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.credits_used | integer |
$.language | string |
$.languages | array |
$.languages[] | string |
$.segments | array |
$.segments[] | object | string |
$.segments[].end | number |
$.segments[].start | number |
$.segments[].text | string |
$.source | string |
$.subtitles | array |
$.subtitles[] | object |
$.subtitles[].Format | string |
$.subtitles[].LanguageCodeName | string |
$.subtitles[].LanguageID | string |
$.subtitles[].Size | integer |
$.subtitles[].Source | string |
$.subtitles[].Url | string |
$.subtitles[].UrlExpire | integer |
$.subtitles[].Version | string |
$.text | string |
$.video | object |
$.video.ai_generated | null |
$.video.author | object |
$.video.author.avatar | string |
$.video.author.id | string |
$.video.author.nickname | string |
$.video.author.username | string |
$.video.author.verified | boolean |
$.video.author_info | object |
$.video.author_info.avatar_medium | string |
$.video.author_info.avatar_thumb | string |
$.video.author_info.private | boolean |
$.video.author_info.sec_uid | string |
$.video.author_info.signature | string |
$.video.author_info.url | string |
$.video.author_stats | object |
$.video.author_stats.diggCount | string |
$.video.author_stats.followerCount | string |
$.video.author_stats.followingCount | string |
$.video.author_stats.friendCount | string |
$.video.author_stats.heart | string |
$.video.author_stats.heartCount | string |
$.video.author_stats.videoCount | string |
$.video.challenges | array |
$.video.cover | string |
$.video.create_time | string |
$.video.create_time_unix | integer |
$.video.desc | string |
$.video.diversification_labels | null |
$.video.duet_enabled | boolean |
$.video.duration | integer |
$.video.hashtags | array |
$.video.id | string |
$.video.images | array |
$.video.is_ad | boolean |
$.video.location_created | null |
$.video.mentions | array |
$.video.music | object |
$.video.music.author | string |
$.video.music.id | string |
$.video.music.title | string |
$.video.music_info | object |
$.video.music_info.album | null |
$.video.music_info.cover | string |
$.video.music_info.duration | integer |
$.video.music_info.original | boolean |
$.video.music_info.play_url | string |
$.video.pinned | null |
$.video.poi | null |
$.video.private_item | boolean |
$.video.share_enabled | boolean |
$.video.stats | object |
$.video.stats.collectCount | string |
$.video.stats.commentCount | string |
$.video.stats.diggCount | string |
$.video.stats.playCount | string |
$.video.stats.repostCount | string |
$.video.stats.shareCount | string |
$.video.stitch_enabled | boolean |
$.video.suggested_words | array |
$.video.suggested_words[] | string |
$.video.url | string |
$.video.video | object |
$.video.video.bitrate | integer |
$.video.video.bitrates | array |
$.video.video.bitrates[] | object | string |
$.video.video.bitrates[].bitrate | integer |
$.video.video.bitrates[].codec | string |
$.video.video.bitrates[].gear | string |
$.video.video.bitrates[].height | integer |
$.video.video.bitrates[].quality | integer |
$.video.video.bitrates[].size | integer |
$.video.video.bitrates[].urls | array |
$.video.video.bitrates[].urls[] | string |
$.video.video.bitrates[].width | integer |
$.video.video.codec | string |
$.video.video.cover | string |
$.video.video.definition | string |
$.video.video.download_url | string |
$.video.video.dynamic_cover | string |
$.video.video.format | string |
$.video.video.height | integer |
$.video.video.origin_cover | string |
$.video.video.play_url | string |
$.video.video.quality | string |
$.video.video.ratio | string |
$.video.video.size | integer |
$.video.video.subtitles | array |
$.video.video.subtitles[] | object |
$.video.video.subtitles[].format | string |
$.video.video.subtitles[].language | string |
$.video.video.subtitles[].source | string |
$.video.video.subtitles[].url | string |
$.video.video.width | integer |
$.video_id | string |