Skip to main content
POST
TikTok Playlists API

TikTok Playlists

Creators group their videos into playlists for series, tutorials and recurring formats. This endpoint lists a user’s public playlists with the playlist name, cover and how many videos each one holds, which reveals how a creator organizes their catalog and which formats they keep coming back to.
username is required. results_limit defaults to 20 and accepts 1 to 100. An account without public playlists returns an empty result, which is not charged.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

username is required. Returns the account's public playlists with their video counts. results_limit defaults to 20 and accepts 1 to 100.

username
string
required

TikTok username, with or without the leading @.

Minimum string length: 1
Pattern: ^@?[A-Za-z0-9_.]{2,24}$
callback_url
string<uri>
results_limit
integer
default:20
Required range: 1 <= x <= 100

Response

Task accepted

code
integer
data
object