TikTok

Playlist

Get a creator’s playlist: its title, cover and author, plus its videos in order.

Endpoint

GET
/s/tiktok/playlist

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 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