Get the most recent Spotify monthly listeners value.
Spotify uses 28 rolling days (4 weeks of 7 days) to measure a month. It makes sense as the number of days in a month varies from 28 to 31, and people’s behavior depends more on the days of the week than on dates within a single month. This way, there is always an equal number of each day within the 28 rolling day ‘monthly listeners’ stats.
Once a week, this endpoint also returns Spotify's "Where people listen" stats, showing the top 50 cities for monthly listeners.
To find an artist's UUID, use either the Get artist by platform ID or Search artist by name endpoints.
GET /api/v2/artist/{uuid}/streaming/spotify/listeners
Parameter name | Value | Description | Additional |
---|---|---|---|
uuid | string | An artist UUID |
Required |
Status code | Description | Resource |
---|---|---|
200 | OK
A Streaming Account response with latest Spotify monthly listeners |
Streaming Plot Collection |
401 | Unauthorized
You are not logged in |
|
403 | Forbidden
This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access. |
|
404 | Not Found
Artist not found |