TikTok Playlists
A TikTok playlist is a named group of a creator's own videos, such as a story told in parts, a tutorial series or a recurring segment, shown on their profile with a cover and a video count. Listing them by username shows which series a creator has packaged and how many videos each one holds.
TikTok Playlists API Features
- Every public playlist on a profileSend a username and get each public playlist as its own record, up to results_limit, which runs from 1 to 100 and defaults to 20.
- Series depth in item_countitem_count is the number of videos in the playlist, so a long-running series stands out from a grouping of a few clips.
- Title, cover and a direct linktitle, cover_url and the playlist url come with every record, and author repeats the owner's id, handle and avatar so records stay self-contained.
TikTok Playlists API Parameters
| Parameters | Required | Description |
|---|---|---|
username | Required | The TikTok username whose playlists to list, with or without the leading @. |
results_limit | Optional | How many playlists to return, from 1 to 100. Defaults to 20. |
How to Use the TikTok Playlists API
Submit a username to the TikTok Playlists API and read the creator's playlists.
- POST {"username": "zachking"} to /v1/tiktok/user-playlists.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read playlists from results.items; follow results.next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"zachking"}'
# Each item is one playlist with title and item_count.TikTok Playlists API Use Cases
- Benchmarking series formats in a niche: Run the TikTok Playlists API across creators in one category and compare title and item_count to see which series formats they keep investing in and how long a run they sustain.
- Vetting a partner before a recurring deal: Check whether a prospective collaborator already organises content into series, and how deep those series go, before proposing a multi-part or recurring partnership.
TikTok Playlists API Pro Tips
- Match TikTok Playlists API snapshots on id, not title, because a creator can rename a playlist.
- Sort by item_count to bring a creator's longest-running series to the top before you read the titles.
Related APIs
Beyond the TikTok Playlists API, use these APIs when you need a different type of public TikTok data.
- TikTok Profiles API — Retrieve public profile identity, biographies, account flags, and audience counts by username.
- TikTok Videos API — Retrieve creator, caption, media, music, tags, mentions, and engagement from video URLs.
- TikTok User Videos API — Collect public profile-feed videos by username with captions, creators, media, timestamps, engagement, and source-account context.
- TikTok Trending Feed API — Collect the current public video feed for a region with creator, caption, cover, timestamp, and visible engagement fields.
- TikTok Video Transcript API — Extract available transcript text, language, format, and source context from public video URLs.
- TikTok Reposts API — List the videos an account has reposted, with each original author, caption, and view count.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API