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 name 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 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). Required for apple-music and amazon

offset integer

Get results starting from position

limit integer

Number of results (max. 100)

sortBy string

Sort criteria. Available values are : audience, name

sortOrder string

Sort order. Available values are : asc, desc

Response

Status 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.


Explore this api

platform

A playlist platform code

type

A playlist type (algorithmic, charts, curators_listeners, editorial, algotorial, major, radios, this_is.)

countryCode

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

offset

Get results starting from position

limit

Number of results (max. 100)

sortBy

Sort criteria. Available values are : audience, name

sortOrder

Sort order. Available values are : asc, desc

Try it out!