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.

We update the global monthly listeners stat each day. Once a week, the endpoint also returns Spotify's "Where people listen" stats, showing the top 50 cities for monthly listeners.

The API response may not return a value for all dates, as we may miss a day or two. These data points may still show on our UI because we are interpolating the missing data between two points.

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/{year}/{month}

Path parameters

Parameter name Value Description Additional
uuid string

An artist UUID

year integer

Year YYYY format

month integer

Month MM format



Status code Description Resource
200 OK

A Streaming Account response with Spotify monthly listeners

Streaming Plot Collection
400 Bad Request

Invalid date provided

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


Year YYYY format


Month MM format

Try it out!