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.

Request

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

Path parameters

Parameter name Value Description Additional
uuid string

An artist UUID

Required

Response

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


Explore this api

uuid

An artist UUID

Try it out!