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.

Query Parameters
  • offset
    Type: integer
    min:  
    0
    max:  
    10000

    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).

  • limit
    Type: integer
    min:  
    1
    max:  
    0

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

  • tagIds[]
    Type: array integer[] · genre ID[]

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

  • sortColumn
    Type: string enum

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

    values
    • active_ratio
    • last_updated
    • num_track
    • vdiff_month
    • vdiff_percent_month
    • vdiff_percent_week
    • vdiff_week
    • views
  • sortOrderDesc
    Type: boolean

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

  • indie
    Type: boolean

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

  • editorial
    Type: boolean

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

  • topPlaylist
    Type: boolean

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

  • descriptionSearch
    Type: string

    Substring match against the playlist description.

  • userListIds[]
    Type: array integer[] unique!

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

Responses
  • application/json
Request Example for get/api/playlist/youtube/lists
curl https://api.chartmetric.com/api/playlist/youtube/lists \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "position": 1,
      "id": 1645080,
      "code2": null,
      "playlist_id": "37i9dQZF1DXcBWIGoYBM5M",
      "name": "Today's Top Hits",
      "image_url": "https://i.scdn.co/image/ab67706f00000003a3b1c73cabef96367d1fc553",
      "personalized": false,
      "followers": 27093574,
      "last_updated": "2020-12-21T06:55:23.752Z",
      "owner_name": "Spotify",
      "owner_id": 2,
      "user_id": "spotify",
      "editorial": true,
      "fdiff_week": 15895,
      "fdiff_percent_week": 0.05866704777,
      "fdiff_month": 56338,
      "fdiff_percent_month": 0.2079386057,
      "catalog": "frontline ",
      "active_ratio": 1,
      "genre": "pop, top lists"
    }
  ],
  "offset": 0,
  "total": 1436332
}

Success