TikTok

Captions

Get a video’s subtitle tracks, both as plain text and as the original WebVTT file.

Endpoint

GET
/s/tiktok/captions

Send your API key in the X-API-Key header. tiktok is the usual service slug; use the one shown on your subscription if it differs.

Query parameters

NameDescription
urlrequired
Link to the video. You can pass the numeric ID as id instead.Example: https://www.tiktok.com/@scout2015/video/6718335390845095173
langoptional
Only return tracks whose language starts with this, e.g. en or eng-US.Example: en

Example request

curl '/s/tiktok/captions?url=https%3A%2F%2Fwww.tiktok.com%2F%40scout2015%2Fvideo%2F6718335390845095173&lang=en' \
  -H 'X-API-Key: YOUR_API_KEY'

Example response

The result is in data. Fields the platform didn't report are left out. Field reference: response shapes.

{
  "data": {
    "id": "6718335390845095173",
    "items": [
      {
        "language": "eng-US",
        "label": "English (US)",
        "url": "https://v16.tiktokcdn.example/sub.vtt",
        "format": "webvtt",
        "autoGenerated": true,
        "text": "Scramble up your name\nand I will try to guess it",
        "vtt": "WEBVTT\n\n00:00:00.000 --> 00:00:02.000\nScramble up your name\n\n00:00:02.000 --> 00:00:04.000\nand I will try to guess it"
      }
    ]
  }
}

Notes