Overview

Sections

Theme switcher

Get Playlist

Header Parameters

StoreIdstring Required

API Key provided by Tuned Global for accessing the service

Path Parameters

idinteger Required

The playlist ID to open, taken from any browse, search or tag listing. It must be public - a private or draft playlist returns 404 here even though it exists.

Response

200
Object

The playlist header only - Name, Description and CoverImage are arrays of language/value pairs, so match your listener's locale rather than assuming the first entry.

Response Attributes

PlaylistIdinteger

Id of this playlist

Namearray

Name of this playlist

Show child attributes

Descriptionarray

Description / blurb for this playlist

Show child attributes

CreatorIdinteger

Id of the user that made this playlist

CreatorNamestring

Name of the user that made this playlist

CreatorImagestring

URL of an Creator image for this playlist

IsCreatorPublicboolean

Is this playlist publicly visible?

TrackCountinteger

Number of tracks within this playlist

PublicTrackCountinteger

Number of tracks within this playlist for dynamic playlist

IsDynamicboolean

Is this Dyanmic playlist

IsLimitedToContentLangboolean

Is this Dyanmic playlist

DurationSecsinteger

Total duration of this playlist, in seconds

IsPublicboolean

Is this playlist publicly visible?

AllowSuggestionsboolean

Is this playlist editable by users other than the creator?

DateCreatedstring

Timestamp when this playlist was first created

DateUpdatedstring

Timestamp when this playlist was last edited

TrackIdsarray

List of the track ids in this playlist

CoverImagearray

URL to a cover image for this playList (if any)

Show child attributes

ContentLanguagestring

Language of playlist

IsVideoboolean

Returns true if video otherwise false

StationIdinteger

Returns the Id of the station

IsDraftboolean

An optional boolean indicating whether the playlist is in draft status

ContentTiernumber

Used to control and manage the classification of content within the playlist metadata update process

Enum values:
Tier0Tier1Tier2
IsExplicitboolean
Typestring
404
Object

No playlist with that ID, or it exists but is not public. Show 'playlist unavailable' rather than an error - a private playlist and a deleted one are indistinguishable here by design.

Was this section helpful?

GET

/

Select
1

Response

Was this section helpful?