Get chart entries
Get current/past chart entries for a specific song.
The Get platforms for song charts endpoint lists available platforms.
In the response:
- rankDate is the last date the song appeared in this chart.
- entryDate is the first date the song appeared in this chart.
- oldPosition for a current chart entry is the last known position for the song prior to the current position.
- oldPosition for a past chart entry is the last known position before the song left the chart.
- When the position field is "0", it means that the song is no longer in the chart, ie. that the current version of that chart does not feature that song.
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}/charts/ranks/{platform}
Path parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| uuid | string | A Song UUID | Required |
| platform | string | A song chart platform code | Required |
Query string parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| currentOnly | integer | Get only the current positions in charts with 1, or the current and past positions with 0. | Optional |
| offset | integer | Get results starting from position | Optional |
| limit | integer | Number of results (max. 100) | Optional |
| sortBy | string | Sort criteria. Available values are : position, rankDate | Optional |
| sortOrder | string | Sort order. Available values are : asc, desc | Optional |
Response
| Code | Description | Resource |
|---|---|---|
| 200 |
OK
A song rank collection response |
Song Rank 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 |