tiktok/
user-playlists

The TikTok Playlists API lists the public playlists on any TikTok creator's profile from a username, with each playlist's name, link, cover image, video count, and owner details.

TikTok Playlists API

Username input
Playlist names
Video count per playlist
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
usernameRequiredThe TikTok username whose playlists to list, with or without the leading @.
results_limitOptionalHow 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.

  1. POST {"username": "zachking"} to /v1/tiktok/user-playlists.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

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.

Explore other platforms

Combine TikTok data with public data from other supported social platforms.

TikTok Playlists API — FAQ

TikTok Playlists API is a programmatic interface for listing the public playlists on a TikTok creator's profile, from their username. It returns each playlist's ID, name, link, cover image, video count and owner details.

No. Each record describes the playlist itself, and item_count tells you how many videos it holds. For the creator's videos, use TikTok User Videos.

No. A playlist is a creator's public grouping of their own videos on the profile, and that is what this returns. Collections are personal folders of saved videos and are not part of the result.

The creator has no public playlists, which is common because TikTok limits playlist creation to eligible creators. The task still succeeds and nothing is charged; each playlist returned costs 0.5 credits.

Run the same username again later and compare each playlist's item_count; collected_at on every record dates the snapshot.