CHchartmetric
Playlist

List Spotify Playlists

List spotify 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/spotify/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.

curatorIds[]string[]

Filter by platform-native curator (user) IDs that own the playlist (e.g. Spotify user IDs).

excludedCuratorListIds[]string[]

Exclude playlists owned by these platform-native curator (user) IDs.

sortColumn'active_ratio' | 'fdiff_month' | 'fdiff_percent_month' | 'fdiff_percent_week' | 'fdiff_week' | 'followers' | 'last_updated' | 'num_track' | 'playlist_updated' | 'score_100'

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.

code2string

ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

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.

majorCuratorboolean

Filter to only playlists owned by a major-label curator (Sony, Universal, Warner, etc.).

newMusicFridayboolean

Filter to only New Music Friday-style new-release 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.