Get song chart list by platform
Get a listing of available song charts for a specific platform (and a specific country).
The Get platforms for song charts endpoint lists available platforms for song charts.
Note: the platform “Airplay” is used for all radio charts made by Soundcharts.
Request
GET /api/v2/chart/song/by-platform/{platform}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| platform | string | A song chart platform code |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| countryCode | string | Country code (2 letters ISO 3166-2, example: 'US', full list on https://en.wikipedia.org/wiki/ISO_3166-2) |
|
| offset | integer | Get results starting from position |
|
| limit | integer | Number of results (max. 100) |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
A Song Chart Collection response |
Chart 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
Platform not found |