Get chart song entries
Get current/past song chart entries for a specific artist.
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 name | Value | Description | Additional |
|---|---|---|---|
| uuid | string | An artist UUID |
Required |
| platform | string | An Artist Chart platform code |
Required |
Query string parameters
| 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 |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
An Artist Chart Song Ranks response |
Artist Chart Ranks |
| 400 | Bad Request
Invalid platform code provided |