Get playlists by type
Get the listing of all playlist with a specific type/nationality.
The Get platforms for playlist data endpoint lists available platforms.
All playlist types are listed in this article from our help center.
Request
GET
/api/v2.20/playlist/by-type/{platform}/{type}
Path parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| platform | string | A playlist platform code | Required |
| type | string | A playlist type (algorithmic, charts, curators_listeners, editorial, algotorial, major, radios, this_is.) | Required |
Query string parameters
| Parameter | 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). Required for apple-music and amazon | Optional |
| offset | integer | Get results starting from position | Optional |
| limit | integer | Number of results (max. 100) | Optional |
| sortBy | string | Sort criteria. Available values are : audience, name | Optional |
| sortOrder | string | Sort order. Available values are : asc, desc | Optional |
Response
| Code | Description | Resource |
|---|---|---|
| 200 |
OK
A playlist collection response |
Playlist 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. |