CHchartmetric
Playlist

List Youtube Playlists

List youtube playlists with filters (flags, catalogs, tags, moods, activities, etc.), sorting, and pagination. Response shape varies slightly per platform (e.g. Spotify exposes followers/fdiff_*, YouTube exposes views/vdiff_*, SoundCloud exposes latest/monthly_diff). Reach/follower columns may exceed the 32-bit range.

get/api/playlist/youtube/lists

Request

Query parameters

offsetinteger

Number of items to skip from the start of the result set; pair with limit to paginate. offset + limit must be ≤ 10,000 (Elasticsearch window).

limitinteger

Maximum number of playlists to return per request. Defaults to 50; max 10000. offset + limit must be ≤ 10,000.

tagIds[]integer[]

Filter by Chartmetric genre/tag IDs the playlist is tagged with.

sortColumn'active_ratio' | 'last_updated' | 'num_track' | 'vdiff_month' | 'vdiff_percent_month' | 'vdiff_percent_week' | 'vdiff_week' | 'views'

Column to sort playlists by. Allowed values vary per platform; default also varies per platform.

sortOrderDescboolean

If true, sort sortColumn in descending order. Defaults to true.

indieboolean

Filter to only playlists tagged as indie (independently curated).

editorialboolean

Filter to only editorial playlists curated by the platform (e.g. Spotify-owned). Defaults to true; pass false to include user-curated playlists.

topPlaylistboolean

Filter to only top playlists (high-reach, frequently-updated playlists curated by Chartmetric editors).

descriptionSearchstring

Substring match against the playlist description.

userListIds[]integer[]

Filter by Chartmetric shortlist (user list) IDs the playlist is included on. Public API exposes this as shortlistIds.

Response

Success

offsetinteger required

Echo of the request offset for client-side pagination tracking.

totalinteger required

Total number of playlists matching the filters before limit/offset are applied.

Changes

No recorded changes to this operation across all 1 revision of this API.