This endpoint returns the platform ID along with the audience count.

Available platforms and associated values are described below:

Platform Value
Shazam Count
Spotify Streams
Youtube Views
Instagram Number of reels
Soundcloud Plays
Audiomack Plays
Genius Page views
Gaana Favorites
JioSaavn Plays
Melon Likes
Line Music Streams
Anghami Plays
Last.fm 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.

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

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


Explore this api

uuid

A Song UUID

platform

A platform code

startDate

Optional period start date (format YYYY-MM-DD), period cannot exceed 90 days

endDate

Optional period end date (format YYYY-MM-DD), leave empty to use latest 90 days

identifier

Optional song identifier (example : 2Fxmhks0bxGSBdJ92vM42m)

Try it out!