Spotify Monthly Listeners

Pricing

Rating

Developer

Actor stats

Categories

Share

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 playlist URLs returned by this actor into the other. In addition, you get the artists' top cities and tracks, as well as their releases, other artists' releases they appear on, their social media accounts, biographies, avatar and banner images, upcoming events, and whether they are "verified" or not.

Beware of expensive and (very) slow imitations. Despite frequent changes to Spotify authentication, now largely handled automatically, this actor still doesn't rely on expensive headless browsers. Everything happens in a light-weight pure Python/Scrapy container. To get best value, try and submit multiple artists in the startURLs parameter, you can usually crawl 100 artists in under a minute that way. Some crawlers would take nearly an hour, with platform-usages costs to match.

Input Fields

• startURLs: URLs in the form https://open.spotify.com/artist/SPOTIFY_ID, eg: https://open.spotify.com/artist/2pvfGvbL4mouaDY9ZSwUmv
• URLs in the form https://open.spotify.com/LOCALE/artist/SPOTIFY_ID are also valid.
• (The locale MUST be in the form of a lower-case ISO 639-1 language code, joined to an upper-case ISO_3166-1 country-code by an underscore, e.g: en_US, zh-CN, fr-FR...)
• (If you are crawling several artists, you will get more "Bang for your Buck" if you have multiple startURLs per run.)
• 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
• locale: The locale to use, if not already specified in the URL as above.

Output Format

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

[
{
"artist_name":"Cruel Diagonals",
"artist_id":"0C7jgMYmKXPmy5bHH5ebEN",
"followers":1670,
"monthlyListeners":3524,
"verified":true,
"avatarImage":"https://i.scdn.co/image/ab67616100005174727cf97e49eaca2e0411e66e",
"headerImage":"https://i.scdn.co/image/ab676186000010160004716795f0d9198c8696f4",
"gallery":[
"https://i.scdn.co/image/ab6761670000ecd4c891079bac8e7d1e65a9988a"
],
"timestamp":"2024-01-27T18:19:36.713298",
"FACEBOOK":"https://facebook.com/crueldiagonals/",
"INSTAGRAM":"https://instagram.com/crueldiagonals",
"TWITTER":"https://twitter.com/crueldiagonals",
"topCities":[
{
"numberOfListeners":57,
"city":"Warsaw",
"country":"PL",
"region":"14"
}
],
"biography":"Since 2016, Los Angeles-based multimedia artist, Cruel Diagonals...",
"related":[
{
"id":"0BUiirjlNsKKVBqxuPctXw",
"name":"Death Qualia",
"image":"https://i.scdn.co/image/ab67616d00001e02c4aab2b4a9b2d7356a651f00"
}
],
"releases":[
{
"id":"4LLeRNBrcuwxj6QrhMmQ0K",
"name":"Fractured Whole",
"type":"ALBUM",
"label":"Beacon Sound",
"date":"2023-03-24",
"url":"https://open.spotify.com/album/4LLeRNBrcuwxj6QrhMmQ0K?si=C-SZuu6aRKWEE1twu7-4hg",
"tracks":11,
"image":"https://i.scdn.co/image/ab67616d0000b273ce0e56337a4558caf5fb50a5",
"copyright":"2023 Cruel Diagonals"
}
],
"topTracks":[
{
"id":"6IZrWKNy07OMGLKU24KJhQ",
"name":"Innate Abstraction",
"playcount":172747,
"duration":177655,
"artists":"Cruel Diagonals",
"album":"46C7T2d104a8fZGaMyJaLr",
"image":"https://i.scdn.co/image/ab67616d0000b27331b4784e8e6eec1cfe8c389b",
"contentRating":"NONE"
}
],
"discoveredOn":[
{
"id":"37i9dQZF1DX8OUvJF6ATAB",
"name":"Exospheres",
"description":"Explore the inner worlds floating in the imagination of experimental Ambient music producers.",
"owner":"Spotify",
"url":"https://open.spotify.com/playlist/37i9dQZF1DX8OUvJF6ATAB",
"image":"https://i.scdn.co/image/ab67706f00000002be7d0bf41d8f366bafc3f4fc"
}
],
"appearsOn":[
{
"id":"6gvAY3mEH9j4JfHgqkQY0P",
"name":"Becoming Everything: Strega Beata Remixed",
"artist_name":"Lana Del Rabies",
"artist_id":"1IoH5ykVwG4K5c98iAhQYk",
"url":"https://open.spotify.com/album/6gvAY3mEH9j4JfHgqkQY0P?si=Z7HIPnrTSdSfjeZH3xcdLQ",
"type":"ALBUM",
"image":"https://i.scdn.co/image/ab67616d0000b2737fef0c516db8f4f28dfa9be5"
}
],
"events":[
{
"id":"1dnXGIzTm14lTwcOCSi2PK",
"name":"Cruel Diagonals, DJ Dolomedes, Mind Mirage, 55Castles",
"url":"https://open.spotify.com/concert/('1dnXGIzTm14lTwcOCSi2PK',)",
"date":"2025-04-01T19:00:00-07:00",
"venue":"Gold-Diggers",
"location":"Los Angeles"
}
]
}
]

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