Get tracklisting for a date
Get the playlist’s tracklisting for a date.
To avoid unnecessary requests, you can first get the dates with available data from the Get tracklisting dates endpoint.
The latestSubscriberCount data point returns the main audience number for the following services:
- Spotify (likes)
- Deezer (fans)
- YouTube (views)
- Audiomack (favorites)
- Boomplay (favorites)
- Gaana (favorites)
- JioSaavn (followers)
- Kuwo (streams)
- Line Music (likes)
- Melon (streams)
- QQ Music (streams)
- Soundcloud (likes)
- Yandex (likes)
Playlist refresh depends on the playlist size:
- between 6 and 10 followers - refreshed every 3 days
- between 11 and 50 followers - refreshed every 2 days
- between 51 and 5,000 followers - refreshed every day
- above 5,000 - refreshed every 2 hours
- New Music Friday - refreshed every hour
All playlist types are listed in this article from our help center.
Need to get the playlist UUID? Use the Get playlist by platform ID or Search playlist by name endpoint.
Request
/api/v2.20/playlist/{uuid}/tracks/{datetime}
Path parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| uuid | string | A playlist UUID | Required |
| datetime | string | A ranking date (ATOM format) | Required |
Query string parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| offset | integer | Get results starting from position | Optional |
| limit | integer | Number of results (max. 100) | Optional |
Response
| Code | Description | Resource |
|---|---|---|
| 200 |
OK
A playlist track collection response |
Playlist Track Collection |
| 400 |
Bad Request
Invalid date provided |
|
| 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
Playlist not found |