Get current/past album chart entries for a specific artist.
The Get platforms for album 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.
GET /api/v2.28/artist/{uuid}/charts/album/ranks/{platform}
Parameter name | Value | Description | Additional |
---|---|---|---|
uuid | string | An artist UUID |
Required |
platform | string | An Artist Chart album platform code |
Required |
Parameter name | Value | Description | Additional |
---|---|---|---|
currentOnly | integer | Get only the current positions in charts with 1, or the current and past positions with 0. |
|
offset | integer | Get results starting from position |
|
limit | integer | Number of results (max. 100) |
|
sortBy | string | Sort criteria. Available values are : position, rankDate |
|
sortOrder | string | Sort order. Available values are : asc, desc |
Status code | Description | Resource |
---|---|---|
200 | OK
An Artist Chart Album Ranks response |
Artist Chart Album Ranks |
400 | Bad Request
Invalid platform code provided |