Get TikTok User Playlist

Fetch the playlists a creator has organised on their profile. Each entry comes back with its cover image, title, the creator record it belongs to and the number of videos it collects, which is enough to rebuild the playlist strip of a profile page or to decide which collections are worth expanding. Count and cursor handle paging for accounts that keep many playlists.

Try on Playground

PrimeApi Endpoints > User Endpoints > User Playlist

Endpoint Info

Request Method

GET

Request URL

https://api.primeapi.co/user-playlist?secUid={secUid}&count={count}&cursor={cursor}

Required Parameters

secUid

Optional Parameters

count, cursor

Request Examples

Request Flow

User Playlist is a single GET call to /user-playlist, and secUid has to travel with it in the query string. count, cursor then shape what comes back. Swap YOUR_API_KEY for your own key and both snippets below run as they are.

Authentication

Header based. Send X-PrimeAPI-Key with every request — there is no OAuth handshake and no token to refresh.

Credits

One User Playlist call costs 1 credit. Your remaining balance comes back on every response in the X-PrimeAPI-Balance header, so you can watch usage without a second lookup.

cURL

curl -X GET "https://api.primeapi.co/user-playlist?secUid=MS4wLjABAAAAWFGzG2-_92Qv9a1I2XZIto24-CxXu2BRC3-HbwH13Y2SIsqt_j1XrNrvYOSHN6q4&count=20&cursor=0" \
  -H "X-PrimeAPI-Key: YOUR_API_KEY"

Python - Requests

import requests

url = "https://api.primeapi.co/user-playlist?secUid=MS4wLjABAAAAWFGzG2-_92Qv9a1I2XZIto24-CxXu2BRC3-HbwH13Y2SIsqt_j1XrNrvYOSHN6q4&count=20&cursor=0"
headers = {"X-PrimeAPI-Key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)

print(response.json())
print("Credits left:", response.headers.get("X-PrimeAPI-Balance"))

Endpoint Response

Example URL

https://api.primeapi.co/user-playlist?secUid=MS4wLjABAAAAWFGzG2-_92Qv9a1I2XZIto24-CxXu2BRC3-HbwH13Y2SIsqt_j1XrNrvYOSHN6q4&count=20&cursor=0

Content Type

JSON

Example Response

{
    "cursor": "20",
    "extra": {
        "fatal_item_ids": [],
        "logid": "2025011700591372FD9F6600FDC619978B",
        "now": 1737075554000
    },
    "hasMore": true,
    "log_pb": {
        "impr_id": "2025011700591372FD9F6600FDC619978B"
    },
    "playList": [
        {
            "cover": "https://p16-sign-sg.tiktokcdn.com/obj/tos-alisg-p-0037/ea5627e957f94f3aa4456c2f21d6f3db_1698889785?lk3s=81f88b70&x-expires=1737093600&x-signature=BST59lIIOjxApRLBNt8JTb7OyEo%3D&shp=81f88b70&shcp=-",
            "creator": {
                "avatarLarger": "https://p9-sign-sg.tiktokcdn.com/aweme/1080x1080/tos-alisg-avt-0068/39c589a926dd3cb6484bc97c04f0b70f.jpeg?lk3s=a5d48078&nonce=26828&refresh_token=25930de8e5322a177ca04442b7440851&x-expires=1737244800&x-signature=H7Rc58aEPTWSOPVopEOhlU5tbmI%3D&shp=a5d48078&shcp=81f88b70",
                "avatarMedium": "https://p16-sign-sg.tiktokcdn.com/aweme/720x720/tos-alisg-avt-0068/39c589a926dd3cb6484bc97c04f0b70f.jpeg?lk3s=a5d48078&nonce=76397&refresh_token=4aca034c10df0e29c6d77a20be87e985&x-expires=1737244800&x-signature=1w1NzLKmn7VrHFFAR3TZZ2cuKmM%3D&shp=a5d48078&shcp=81f88b70",
                "avatarThumb": "https://p16-sign-sg.tiktokcdn.com/aweme/100x100/tos-alisg-avt-0068/39c589a926dd3cb6484bc97c04f0b70f.jpeg?lk3s=a5d48078&nonce=63361&refresh_token=6560886d93ad757109a19e4ce431c49c&x-expires=1737244800&x-signature=J%2FCBEK%2BTV7tpULxlnCgPxFj5mxs%3D&shp=a5d48078&shcp=81f88b70",
                "ftc": false,
                "id": "6724460466796282882",
                "isADVirtual": false,
                "nickname": "Tiin.vn",
                "openFavorite": false,
                "privateAccount": true,
                "relation": 0,
                "secUid": "MS4wLjABAAAAWFGzG2-_92Qv9a1I2XZIto24-CxXu2BRC3-HbwH13Y2SIsqt_j1XrNrvYOSHN6q4",
                "secret": true,
                "signature": "Trang tin gi\u1edbi tr\u1ebb h\u00e0ng \u0111\u1ea7u\nFor Work: 0969161718\nEmail: hoptac@viettel.com.vn",
                "uniqueId": "tiin.vn",
                "verified": false
            },
            "id": "7296485031739542273",
            "mixId": "7296485031739542273",
            "mixName": "Interview SMent Idol",
            "name": "Interview SMent Idol",
            "videoCount": 3
        },
        {
  ... (truncated)

Show full response

Guides

How to use User Playlist

How to Get TikTok Playlists via API

Read all TikTok API guides

Related Endpoints

More TikTok User Endpoints

Get TikTok User Info by Username Get TikTok User Info by ID Get TikTok User Followers Get TikTok User Following Get TikTok User Posts Get TikTok User Liked Posts Get TikTok User Repost Get TikTok User Popular Posts Get TikTok User Oldest Posts

View all User Endpoints

Contact

You can contact us via Telegram or Gmail

@primeapi_co

Gmail

primeapico@gmail