Spotify Playlists

Spotify Playlists

The Spotify Playlist API has generous rate-limits, but doesn't actually include an API for an artists' featured playlists. For that, you can use the Spotify Monthly Listeners Actor. (Curiously, there is still no API for monthly listeners either.) You could get an API key and make multiple calls to their playlist API to retrieve metadata and every track, but why bother when you can get them all at once here? You can also retrieve playlists by searching.

Input Fields

• startURLs: URLs in the form https://open.spotify.com/playlist/SPOTIFY_PLAYLIST_ID, eg: https://open.spotify.com/playlist/64K9TrsSg4xuaIxkZTOqz3
• terms: an array of search terms to use, eg: ["vapourwave", "minimalwave"]
• maxTracks: the maximum number of tracks to retrieve per playlist, defaults to 1000 (Be warned that at most 50 tracks can be retrieved per request, and some playlists are rather large.)
• maxItems: the maximum number of playlists to return when searching, defaults to 100
• pageSize: number of results to return per request when searching, defaults to the maximum of 50
• expand: whether to retrieve all the tracks for the search results, defaults to true, subject to maxTracks

Output Format

If you specify playlist URLs, you get playlist metadata and tracks:

1[
2  {
3    "playlistId": "64K9TrsSg4xuaIxkZTOqz3",
4    "playlistName": "Splatter Platters & Death Discs",
5    "description": "Death discs have come under a variety of names over the years...",
6    "ownerName": "mrs.sharpadero",
7    "ownerId": "mrs.sharpadero",
8    "ownerImage": "https://i.scdn.co/image/ab6775700000ee850d450b68ca03d533137a0fe2",
9    "images": [
10      "https://image-cdn-ak.spotifycdn.com/image/ab67706c0000da84f92649defe46fc1b8aab47f9"
11    ],
12    "timestamp": "2024-09-24T21:12:06.301621",
13    "followers": 214,
14    "totalTracks": 70,
15    "tracks": [
16      {
17        "trackName": "Leader Of The Pack",
18        "trackId": "6O5PIO5pAWxdoxvaUFQ02G",
19        "artists": [
20          {
21            "artistName": "The Shangri-Las",
22            "artistId": "1WvziZcLLYLoMMdmQx7qcN"
23         }
24        ],
25        "plays": "35181107",
26        "trackDuration": 171333,
27        "albumName": "The Best Of The Shangri-Las",
28        "albumId": "76fF3MnSilSrvfW1fAWHAZ",
29        "albumArt": "https://i.scdn.co/image/ab67616d0000b2739bd4306ef696c6fcfd8e417b",
30        "contentRating": "NONE",
31        "addedAt": "2022-07-05T06:10:46+00:00",
32        "trackNumber": 2
33      }
34    ]
35  }
36]

Results from searches will also include the searchTerms and searchRank. Unless expand is set true, the output will be somewhat restricted.