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 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


Explore this api

uuid

An artist UUID

platform

An Artist Chart platform code

currentOnly

Get only the current positions in charts with 1, or the current and past positions with 0.

offset

Get results starting from position

limit

Number of results (max. 100)

sortBy

Sort criteria. Available values are : position, rankDate

sortOrder

Sort order. Available values are : asc, desc

Try it out!