Get playlist entries
The Get platforms for playlist data endpoint lists available platforms.
Learn more about our playlist types in our help center.
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.20/song/{uuid}/playlist/current/{platform}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| uuid | string | A Song UUID |
Required |
| platform | string | A playlist platform code |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| type | string | A playlist type. Available values are : 'all' or one of editorial, algorithmic, algotorial, major, charts, curators_listeners, radios, this_is |
|
| offset | integer | Get results starting from position |
|
| limit | integer | Number of results (max. 100) |
|
| sortBy | string | Sort criteria. Available values are : position, positionDate, entryDate, subscriberCount |
|
| sortOrder | string | Sort order. Available values are : asc, desc |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
A song playlist position collection response |
Playlist Position Collection |
| 400 | Bad Request
Invalid request |
|
| 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 |