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

Path parameters

Parameter name Value Description Additional
uuid string

An artist UUID



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 if you want access.

404 Not Found

Artist not found

Explore this api


An artist UUID

Try it out!