Don't know any platform ID? Use the Get song by ISRC endpoint.
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.
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
GET /api/v2.25/song/by-platform/{platform}/{identifier}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| platform | string | A platform code |
Required |
| identifier | string | A song platform Identifier. |
Required |
Response
| Status 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 |