The Get platforms for album charts endpoint lists available platforms.

Need to get the album UUID first? Use the Get album by UPC or Get album by platform ID endpoints.

Request

GET /api/v2.26/album/{uuid}/charts/ranks/{platform}

Path parameters

Parameter name Value Description Additional
uuid string

An album UUID

Required
platform string

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

A album rank collection response

Album Rank Collection
400 Bad Request

Invalid request

401 Unauthorized

You are not logged in

403 Forbidden

This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access.

404 Not Found

Album not found


Explore this api

uuid

An album UUID

platform

A album 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!