Get song ranking dates
Get the available song chart ranking dates.
This endpoint allows you to query the correct date for the Get song ranking for a date endpoint.
Learn more about how we refresh charts in this article from our help center.
Need to get the chart’s slug? Use the Get song chart list by platform endpoint.
Request
GET /api/v2/chart/song/{slug}/available-rankings
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| slug | string | A song chart slug |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| offset | integer | Get results starting from position |
|
| limit | integer | Number of results (max. 100) |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
A Chart Ranking Dates Collection response |
Chart Ranking Dates 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
Chart not found |