Get current stats
This endpoint is restricted to specific plans. Reach out if you have any questions.
Get all the current audience, streaming, popularity, and retention stats for an artist.
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 streaming audience, 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 |