Get Playlists by Tag

Returns public playlists tagged with one tag name in the store catalogue. Each playlist includes localized name and cover, creator details, track count, duration, and tag relevance score.

Use this when: building single-tag playlist browse, such as genre or mood pages and curated recommendation rows under one label. For playlists that must match several tags at once, use Get Playlists By Tags on the playlists route instead.

Security Model

API Key Authentication

Header Parameters

StoreIdstring Required

StoreId API Key provided by Tuned Global for accessing the service

Countrystring

Optional. ISO 3166-1 alpha-2 country code (e.g. AU, TW) used to apply territory rights. Defaults to your store's default country when omitted. Playlist track counts reflect the tracks available in this country.

Query Parameters

tagstring Required

The tag to filter playlists by

typestring

The type of playlists (Audio | Video | Karaoke | All). Default Audio.

Enum values:

AudioVideoKaraokeAll

offsetinteger

The starting row in the result set. The default value is 1.

countinteger

The number of rows to return. The default value is 10.

sortTypestring

The type of sorting to be applied. The default value is popular.

Enum values:

popularnewreleasestitle

Response

200

Object

Results items are full Playlist objects

Response Attributes

Offsetinteger

starting offset of this set

Countinteger

number of results in this set

Totalinteger

total number of results in the parent set we are paging through

Resultsarray

the actual results

Show child attributes

400

Object

Tag is empty/missing

404

Object

No matching playlists

Sections

Get Playlists by Tag

Security Model

Header Parameters

Query Parameters

ResponseExpand all

Response Attributes

Response

Response