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.
Get audience
Get the value of streams/plays/favorites/views for a specific song.
This endpoint returns the platform ID along with the audience count.
Available platforms and associated values are described below:
| Platform | Value |
|---|---|
| Shazam | Count |
| Gaana | Favorites |
| Boomplay | Favorites |
| Audiomack | Plays |
| Melon | Likes |
| Genius | Page views |
| JioSaavn | Plays |
| Anghami | Plays |
| Spotify | Streams |
| Line Music | Streams |
| Youtube | Views |
| Soundcloud | Plays |
Don’t see the audience metric in the response for a specific song? We may not have the song platform ID! Use the Add links endpoint to submit it Soundcharts.
Request
GET /api/v2/song/{uuid}/audience/{platform}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| uuid | string | A Song UUID |
Required |
| platform | string | A platform code |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| startDate | string | Optional period start date (format YYYY-MM-DD), period cannot exceed 90 days |
|
| endDate | string | Optional period end date (format YYYY-MM-DD), leave empty to use latest 90 days |
|
| identifier | string | Optional song identifier (example : 2Fxmhks0bxGSBdJ92vM42m) |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
A song response with platform stream for a period |
SongPlotCollectionResponse |
| 400 | Bad Request
Invalid platform code |
|
| 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 |