Spotify Monthly Listeners

Spotify Monthly Listeners

The Spotify API is comprehensive with generous rate limits, but it doesn't include the rolling tally of unique listeners from the previous 28 days, despite it being publically available on the web. This Actor returns monthly listeners, and much more besides. More specifically, you also get an artist's featured playlists, for which there is also not an official API. You can now crawl these, tracks and all, with the Spotify Playlists Actor. Just pass the URLs returned by this actor into the other. If you're not a dev, and don't want to handle highly nested JSON, you can opt to receive flattened lists of playlists, tracks, releases and related artists instead.

Input Fields

• startURLs: URLs in the form https://open.spotify.com/artist/SPOTIFY_ID, eg: https://open.spotify.com/artist/2pvfGvbL4mouaDY9ZSwUmv
• (Oh, All Right: https://open.spotify.com/LOCALE/artist/SPOTIFY_ID should work too.)
• maxDepth: The maximum recursion depth when crawling related artists, defaults to 1, just the given URLs
• maxArtists: The maximum number of artists to crawl, defaults to 1000

Output Format

By default, you get nested JSON output for each artist, eg:

1[
2  {
3    "artist_name": "Cruel Diagonals",
4    "artist_id": "0C7jgMYmKXPmy5bHH5ebEN",
5    "followers": 1670,
6    "monthlyListeners": 3524,
7    "avatarImage": "https://i.scdn.co/image/ab67616100005174727cf97e49eaca2e0411e66e",
8    "headerImage": "https://i.scdn.co/image/ab676186000010160004716795f0d9198c8696f4",
9    "gallery": [
10      "https://i.scdn.co/image/ab6761670000ecd4c891079bac8e7d1e65a9988a"
11    ],
12    "timestamp": "2024-01-27T18:19:36.713298",
13    "FACEBOOK": "https://facebook.com/crueldiagonals/",
14    "INSTAGRAM": "https://instagram.com/crueldiagonals",
15    "TWITTER": "https://twitter.com/crueldiagonals",
16    "topCities": [
17      {
18        "numberOfListeners": 57,
19        "city": "Warsaw",
20        "country": "PL",
21        "region": "14"
22      }
23    ],
24    "biography": "Since 2016, Los Angeles-based multimedia artist, Cruel Diagonals...",
25    "related": [
26      {
27        "id": "0BUiirjlNsKKVBqxuPctXw",
28        "name": "Death Qualia",
29        "image": "https://i.scdn.co/image/ab67616d00001e02c4aab2b4a9b2d7356a651f00"
30      }
31    ],
32    "releases": [
33      {
34        "id": "4LLeRNBrcuwxj6QrhMmQ0K",
35        "name": "Fractured Whole",
36        "type": "ALBUM",
37        "label": "Beacon Sound",
38        "date": "2023-03-24",
39        "url": "https://open.spotify.com/album/4LLeRNBrcuwxj6QrhMmQ0K?si=C-SZuu6aRKWEE1twu7-4hg",
40        "tracks": 11,
41        "image": "https://i.scdn.co/image/ab67616d0000b273ce0e56337a4558caf5fb50a5",
42        "copyright": "2023 Cruel Diagonals"
43      }
44    ],
45    "topTracks": [
46      {
47        "id": "6IZrWKNy07OMGLKU24KJhQ",
48        "name": "Innate Abstraction",
49        "playcount": 172747,
50        "duration": 177655,
51        "artists": "Cruel Diagonals",
52        "album": "46C7T2d104a8fZGaMyJaLr",
53        "image": "https://i.scdn.co/image/ab67616d0000b27331b4784e8e6eec1cfe8c389b",
54        "contentRating": "NONE"
55      }
56    ],
57    "discoveredOn": [
58      {
59        "id": "37i9dQZF1DX8OUvJF6ATAB",
60        "name": "Exospheres",
61        "description": "Explore the inner worlds floating in the imagination of experimental Ambient music producers.",
62        "owner": "Spotify",
63        "url": "https://open.spotify.com/playlist/37i9dQZF1DX8OUvJF6ATAB",
64        "image": "https://i.scdn.co/image/ab67706f00000002be7d0bf41d8f366bafc3f4fc"
65      }
66    ]
67  }
68]

Flatter Output

Specify flatten to obtain output suitable for exporting as a .csv. The rows will have the columns artist_name, artist_id and timestamp. flatten can be one of:

• artists: all the flat fields of the artists
• playlists: playlists featuring the artists
• tracks: the artists' top tracks
• releases: the artists' singles, albums and compilations

Caveats

• No, the numberOfListeners fields in topCities with not sum to monthlyListeners
• The durations of an artist's topTracks are in milliseconds
• discoveredOn will not be an exhaustive list of playlists featuring an artist