Get chart album entries
Get current/past album chart entries for a specific artist.
The Get platforms for album charts endpoint lists available platforms.
In the response:
- rankDate is the last date the album appeared in this chart.
- entryDate is the first date the album appeared in this chart.
- oldPosition for a current chart entry is the last known position for the album prior to the current position.
- oldPosition for a past chart entry is the last known position before the album left the chart.
- When the position field is "0", it means that the album is no longer in the chart, ie. that the current version of that chart does not feature that album.
Don't know the artist UUID yet? Use the Get artist by platform ID or Search artist by name endpoints.
Request
GET
/api/v2.28/artist/{uuid}/charts/album/ranks/{platform}
Path parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| uuid | string | An artist UUID | Required |
| platform | string | An Artist Chart album 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 Album Ranks response |
Artist Chart Album Ranks |
| 400 |
Bad Request
Invalid platform code provided |