Get song by platform ID
Distributor data is currently in Beta and may contain inaccuracies. If you notice any error, please contact us.
Get Soundcharts’ UUID & the song's metadata.
If you need to find a platform code, use the Get platforms endpoint.
Don't know any platform ID? Use the Get song by ISRC endpoint.
If we do not know the song identifier, you will get a 404 error (this won't be deducted from your API calls quota). The song should be added to Soundcharts within 2 hours, and data will populate within 24 hours. Learn more in the help center.
Review the Get song metadata endpoint for field definitions.
Request
/api/v2.8/song/by-platform/{platform}/{identifier}
Path parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| platform | string | A platform code | Required |
| identifier | string | A song platform Identifier. | Required |
Response
| Code | Description | Resource |
|---|---|---|
| 200 |
OK
A song response |
Song |
| 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 |
|
| 410 |
Gone
ISRC Blacklisted due to multiple tracks identified from DSP |