1 day trial then $5.00/month - No credit card required now
Spotify Monthly Listeners
1 day trial then $5.00/month - No credit card required now
Get an artist's unique monthly listeners, and much 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 crawler returns monthly listeners, and much more besides. 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 "image": "https://i.scdn.co/image/ab67706f00000002be7d0bf41d8f366bafc3f4fc" 64 } 65 ] 66 } 67]
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
- 15 monthly users
- 5 stars
- 100.0% runs succeeded
- Created in Jan 2024
- Modified 29 days ago