Search APIs
Loading…
← API Store
Social

TikTok

TikTok

TikTok video transcript (TikTok captions)

GET /tiktok/v1/video/transcript
Test this endpoint

Every 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

NameTypeDescription
urlrequiredstring Example: https://www.tiktok.com/@x/video/7688809734673108237
languagestring 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
$.cachedboolean
$.credits_usedinteger
$.languagestring
$.languagesarray
$.languages[]string
$.segmentsarray
$.segments[]object | string
$.segments[].endnumber
$.segments[].startnumber
$.segments[].textstring
$.sourcestring
$.subtitlesarray
$.subtitles[]object
$.subtitles[].Formatstring
$.subtitles[].LanguageCodeNamestring
$.subtitles[].LanguageIDstring
$.subtitles[].Sizeinteger
$.subtitles[].Sourcestring
$.subtitles[].Urlstring
$.subtitles[].UrlExpireinteger
$.subtitles[].Versionstring
$.textstring
$.videoobject
$.video.ai_generatednull
$.video.authorobject
$.video.author.avatarstring
$.video.author.idstring
$.video.author.nicknamestring
$.video.author.usernamestring
$.video.author.verifiedboolean
$.video.author_infoobject
$.video.author_info.avatar_mediumstring
$.video.author_info.avatar_thumbstring
$.video.author_info.privateboolean
$.video.author_info.sec_uidstring
$.video.author_info.signaturestring
$.video.author_info.urlstring
$.video.author_statsobject
$.video.author_stats.diggCountstring
$.video.author_stats.followerCountstring
$.video.author_stats.followingCountstring
$.video.author_stats.friendCountstring
$.video.author_stats.heartstring
$.video.author_stats.heartCountstring
$.video.author_stats.videoCountstring
$.video.challengesarray
$.video.coverstring
$.video.create_timestring
$.video.create_time_unixinteger
$.video.descstring
$.video.diversification_labelsnull
$.video.duet_enabledboolean
$.video.durationinteger
$.video.hashtagsarray
$.video.idstring
$.video.imagesarray
$.video.is_adboolean
$.video.location_creatednull
$.video.mentionsarray
$.video.musicobject
$.video.music.authorstring
$.video.music.idstring
$.video.music.titlestring
$.video.music_infoobject
$.video.music_info.albumnull
$.video.music_info.coverstring
$.video.music_info.durationinteger
$.video.music_info.originalboolean
$.video.music_info.play_urlstring
$.video.pinnednull
$.video.poinull
$.video.private_itemboolean
$.video.share_enabledboolean
$.video.statsobject
$.video.stats.collectCountstring
$.video.stats.commentCountstring
$.video.stats.diggCountstring
$.video.stats.playCountstring
$.video.stats.repostCountstring
$.video.stats.shareCountstring
$.video.stitch_enabledboolean
$.video.suggested_wordsarray
$.video.suggested_words[]string
$.video.urlstring
$.video.videoobject
$.video.video.bitrateinteger
$.video.video.bitratesarray
$.video.video.bitrates[]object | string
$.video.video.bitrates[].bitrateinteger
$.video.video.bitrates[].codecstring
$.video.video.bitrates[].gearstring
$.video.video.bitrates[].heightinteger
$.video.video.bitrates[].qualityinteger
$.video.video.bitrates[].sizeinteger
$.video.video.bitrates[].urlsarray
$.video.video.bitrates[].urls[]string
$.video.video.bitrates[].widthinteger
$.video.video.codecstring
$.video.video.coverstring
$.video.video.definitionstring
$.video.video.download_urlstring
$.video.video.dynamic_coverstring
$.video.video.formatstring
$.video.video.heightinteger
$.video.video.origin_coverstring
$.video.video.play_urlstring
$.video.video.qualitystring
$.video.video.ratiostring
$.video.video.sizeinteger
$.video.video.subtitlesarray
$.video.video.subtitles[]object
$.video.video.subtitles[].formatstring
$.video.video.subtitles[].languagestring
$.video.video.subtitles[].sourcestring
$.video.video.subtitles[].urlstring
$.video.video.widthinteger
$.video_idstring