Get chart song entries
Get current/past song chart entries for a specific artist.
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.
The Get platforms for song charts endpoint lists available platforms.
Don't know the artist UUID yet? Use the Get artist by platform ID or Search artist by name endpoints.
Request
GET
/api/v2/artist/{uuid}/charts/song/ranks/{platform}
Path parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| uuid | string | An artist UUID | Required |
| platform | string | An Artist 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
An Artist Chart Song Ranks response |
Artist Chart Ranks |
| 400 |
Bad Request
Invalid platform code provided |