Get current stats
This endpoint is restricted to specific plans. View pricing
Get all the current score, streaming, and popularity stats for a song.
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 and Get popularity.
Learn more about the scores in the help center.
Don’t see any audience metric for one platform in the response for a specific song? We may not have the song platform ID! Use the Add links endpoint to submit it Soundcharts.
Need to get the song UUID first? Use the Get song by ISRC or Get song by platform ID or Search song by name endpoints.
Request
/api/v2/song/{uuid}/current/stats
Path parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| uuid | string | A Song UUID | Required |
Query string parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| period | string | Period | Optional |
Response
| Code | Description | Resource |
|---|---|---|
| 200 |
OK
Current stats response |
CurrentStatsResponse2 |
| 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
Song not found |