TikTok
Playlist
Get a creator’s playlist: its title, cover and author, plus its videos in order.
Endpoint
GET
/s/tiktok/playlistSend 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 playlist. You can pass the numeric ID as id instead.Example: https://www.tiktok.com/@tiktok/playlist/In-The-Mix-7516638364301265695 |
cursoroptional | nextCursor from the previous page. Omit for the first page. The cursor alone is enough: url is not needed with it. |
countoptional | Videos per page (1–50). Default 30. TikTok may return fewer.Example: 30 |
Example request
curl '/s/tiktok/playlist?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fplaylist%2FIn-The-Mix-7516638364301265695&count=30' \
-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": {
"playlist": {
"id": "7516638364301265695",
"title": "In The Mix",
"cover": "https://p16.tiktokcdn.example/playlist-cover.image",
"count": 24,
"url": "https://www.tiktok.com/@tiktok/playlist/In-The-Mix-7516638364301265695",
"author": {
"id": "107955",
"username": "tiktok",
"name": "TikTok",
"avatar": "https://cdn.example/avatar.jpg",
"verified": false
}
},
"items": [
{
"platform": "tiktok",
"id": "7516636731223837983",
"url": "https://www.tiktok.com/@tiktok/video/7516636731223837983",
"type": "video",
"text": "In the mix",
"createdAt": "2025-06-16T17:00:00Z",
"author": {
"id": "107955",
"username": "tiktok",
"name": "TikTok",
"avatar": "https://cdn.example/avatar.jpg",
"verified": false
},
"media": [
{
"type": "video",
"url": "https://v16-webapp-prime.tiktok.example/video.mp4",
"thumbnail": "https://p16.tiktokcdn.example/cover.jpeg",
"width": 576,
"height": 1024,
"duration": 15
}
],
"stats": {
"likes": 52000,
"comments": 900,
"views": 1200000
}
}
],
"nextCursor": "p2:7516638364301265695:20",
"hasMore": true
}
}Notes
- Accepted links: https://www.tiktok.com/@user/playlist/<name>-<id> (query parameters such as ?lang= are ignored), and short links (vm.tiktok.com, vt.tiktok.com, tiktok.com/t/…) that lead to a playlist.
- playlist is only on the first page. Keep calling with nextCursor while hasMore is true, up to 3 pages in total: the third page has no nextCursor.
- A playlist that doesn’t exist or was removed returns 404; a private account returns 403.
- Items have the same shape as the video and photo endpoints. To get a file, pass the item’s url to Download file.