Need to get the song UUID first? Use the Get song by ISRC or Get song by platform ID endpoints.
Get audience
Get the value of streams/plays/favorites 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 |
| 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 |
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 |