TikTok
Video
Download a TikTok video with its cover, every available quality, stats and the list of caption tracks.
Endpoint
GET
/s/tiktok/postSend 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 |
Accepted links
- https://www.tiktok.com/@user/video/<id>
- Short links: https://vm.tiktok.com/<code>, https://vt.tiktok.com/<code>, https://www.tiktok.com/t/<code>
- A numeric video ID (id=6718335390845095173)
Example request
curl '/s/tiktok/post?url=https%3A%2F%2Fwww.tiktok.com%2F%40scout2015%2Fvideo%2F6718335390845095173' \
-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": {
"platform": "tiktok",
"id": "6718335390845095173",
"url": "https://www.tiktok.com/@scout2015/video/6718335390845095173",
"type": "video",
"text": "Scramble up ur name & I’ll try to guess it 😍❤️ #foryoupage",
"createdAt": "2019-07-28T19:45:12Z",
"author": {
"id": "6743219038927391749",
"username": "scout2015",
"name": "Scout & Suki",
"avatar": "https://cdn.example/avatar.jpg",
"verified": false
},
"media": [
{
"type": "video",
"url": "https://v16.tiktokcdn.example/video-1080.mp4",
"thumbnail": "https://p16.tiktokcdn.example/cover.jpeg",
"width": 1080,
"height": 1920,
"duration": 15,
"variants": [
{
"url": "https://v16.tiktokcdn.example/video-720.mp4",
"contentType": "video/mp4",
"bitrate": 1100000,
"width": 720,
"height": 1280
}
]
}
],
"stats": {
"likes": 1240000,
"comments": 24800,
"views": 9500000,
"shares": 3100,
"saves": 18200
},
"captions": [
{
"language": "eng-US",
"label": "English (US)",
"url": "https://v16.tiktokcdn.example/sub.vtt",
"format": "webvtt",
"autoGenerated": true
}
]
}
}Notes
- media[0].url is the best quality; media[0].variants lists the others, best first.
- TikTok only serves its video URLs to the connection that loaded the post, so fetching them yourself returns 403. Use Download file (/download with the post link) to get the video.