TikTok
Playlists
List an account’s playlists: title, cover, video count and link.
Endpoint
GET
/s/tiktok/playlistsSend 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 |
|---|---|
usernamerequired | Account name, with or without the leading @.Example: mrbeast |
urloptional | A profile link (https://www.tiktok.com/@user) instead of username. |
Example request
curl '/s/tiktok/playlists?username=mrbeast' \
-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": {
"items": [
{
"id": "7596415294902389534",
"title": "Beast Games",
"cover": "https://p16.tiktokcdn.example/playlist-cover.image",
"count": 13,
"url": "https://www.tiktok.com/@mrbeast/playlist/Beast-Games-7596415294902389534"
}
],
"hasMore": false
}
}Notes
- All of the account’s playlists come back in one answer; hasMore is false. An account without playlists returns an empty items list. An unknown account returns 404, a private one 403.
- Pass an item’s url to Playlist to get its videos.