The Get platforms for playlist data endpoint lists available platforms.

All playlist types are listed in this article from our help center.

Need to get the playlist UUID? Use the Get playlist by platform ID or Search playlist by name endpoint.

Request

GET /api/v2.20/playlist/by-curator/{platform}/{curatorIdentifier}

Path parameters

Parameter name Value Description Additional
platform string

A playlist platform code

Required
curatorIdentifier string

A playlist curator identifier

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.

404 Not Found

Curator not found


Explore this api

platform

A playlist platform code

curatorIdentifier

A playlist curator identifier

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!