TikTok
Captions
Get a video’s subtitle tracks, both as plain text and as the original WebVTT file.
Endpoint
GET
/s/tiktok/captionsSend 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
| Name | Description |
|---|---|
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
- autoGenerated is true for speech recognition (ASR) and machine-translated tracks.
- A video without captions returns an empty items list.
- The /post response already lists the tracks (without text) in data.captions.