This API returns all current stats of all platforms, with the growth period of your choice. Get more information about each type of stats in these endpoints: Get audience, Get listeners/streams/views, Get popularity, and Get retention.

Don’t see any audience metric for one platform in the response for a specific artist? We may not have the artist platform ID! Use the Add links endpoint to submit it Soundcharts.

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}/current/stats

Path parameters

Parameter name Value Description Additional
uuid string

An artist UUID

Required

Query string parameters

Parameter name Value Description Additional
period string

Period

Response

Status code Description Resource
200 OK

Current stats response

CurrentStatsResponse
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

period

Period

Try it out!