Get chart entries
Get current/past chart entries for a specific song.
The Get platforms for song charts endpoint lists available platforms.
Need to get the song UUID first? Use the Get song by ISRC or Get song by platform ID endpoints.
Request
GET /api/v2/song/{uuid}/charts/ranks/{platform}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| uuid | string | A Song UUID |
Required |
| platform | string | A song 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 song rank collection response |
Song 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
Song not found |