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.

Request

GET /api/v2/artist/{uuid}/streaming/spotify/listeners/{year}/{month}

Path parameters

Parameter name Value Description Additional
uuid string

An artist UUID

Required
year integer

Year YYYY format

Required
month integer

Month MM format

Required

Response

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 help@soundcharts.com if you want access.

404 Not Found

Artist not found


Explore this api

uuid

An artist UUID

year

Year YYYY format

month

Month MM format

Try it out!