Spotify Monthly Listeners
6 hours trial then $5.00/month - No credit card required now
Spotify Monthly Listeners
6 hours trial then $5.00/month - No credit card required now
Get an artist's unique monthly listeners, featured playlists, releases, top cities, and more besides.
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 artistsplaylists
: playlists featuring the artiststracks
: the artists' top tracksreleases
: the artists' singles, albums and compilations
Caveats
- No, the
numberOfListeners
fields intopCities
with not sum tomonthlyListeners
- The durations of an artist's
topTracks
are in milliseconds discoveredOn
will not be an exhaustive list of playlists featuring an artist
Actor Metrics
56 monthly users
-
5 stars
>99% runs succeeded
Created in Jan 2024
Modified 2 months ago