Overview

Content Get

Retrieve a dynamic, CMS-managed page layout by its unique identifier key. Get all the necessary details for these customizable views, which act as architectural templates for Turnkey applications.

Rather than returning heavy catalogue items directly, this endpoint returns a structural configuration map (found in the Value node). Client applications use this configuration to identify layout components—such as headers, spacing, and content widgets—and systematically invoke the secondary APIs required to render the user-discovery experience.

Example Flow: If a promotional homepage banner links to the key new_albums, calling this API with that key retrieves the page blueprint containing its specific layout blocks, component sorting order, and necessary query arguments.

Content Component Types

The CMS handles distinct layout, media, and dynamic data-driven content blocks. Components fall into three structural behaviors:

Layout & Static Components (N/A API): Handled entirely client-side to manage page UI styling (e.g., headers, vertical spacing, paragraphs, or dividers).
Dynamic Catalogue Feeds (Metadata / Services APIs): Require immediate, sequential API calls using the mapped parameters to hydrate dynamic shelves, grids, or lists with live music catalogue data.
User-Contextual Feeds (e.g., User Albums, User Artists): Explicitly pull personalized client data (such as the logged-in user's collection or followed items).

Title

Description

Title

Description

Title

Description

Title

Header	`h`	N/A	N/A	None	N/A	N
Spacing	`spacing`	N/A	N/A	None	N/A	N
Paragraph	`p`	N/A	N/A	None	N/A	N
Image	`img`	N/A	N/A	None	N/A	N
Image by Subpackage	`img_bysubpackage`	N/A	N/A	None	N/A	N
Advertisement	`ad_banner`	N/A	N/A	None	N/A	N
Separator	`separator`	N/A	N/A	None	N/A	N
Tagged Playlists	`playlists_bytag`	Metadata	`tags/playlists`	`tags, offset, count, type`	shelf, grid, verticallist	Y
Tagged Albums	`albums_bytag`	Metadata	`tags/groups/albums`	`groups, types, offset, count`	shelf, grid, list, verticallist	Y
Trending Mixes	`stations_trending`	Metadata	`stations/trending`	None	shelf, grid, verticallist	Y
Trending Artists	`artists_trending`	Metadata	`artists/trending`	None	shelf, grid, list, verticallist	Y
Recommended Artists	`artists_recommended`	Services	`users/me/recommendedartist`	`offset, count`	shelf, grid, list, verticallist	Y
Recommended Stations	`stations_recommended`	Services	`users/me/recommendedstations`	`offset, count`	shelf, grid, verticallist	Y
Tagged Mixes	`stations_bytag`	Metadata	`tags/stations`	`tag, offset, count`	shelf, grid, verticallist	Y
Tagged Artists	`artists_bytag`	Metadata	`tags/artists`	`tag, offset, count`	shelf, grid, list, verticallist	Y
Suggested Mixes	`stations_suggested`	Services	`stations/suggested`	None	shelf, grid, verticallist	N
Trending Albums	`albums_trending`	Metadata	`albums/trending`	`offset, count`	shelf, grid, list, verticallist	Y
Album New Releases	`albums_newreleases`	Metadata	`albums/newbydate`	`offset, count`	shelf, grid, list, verticallist	N
Songs New Releases	`songs_newreleases`	Metadata	`songs/new`	`offset, count`	shelf, grid, verticallist	Y
Trending Songs	`songs_trending`	Metadata	`songs/trending`	`offset, count`	shelf, grid, verticallist	Y
Tagged Songs	`songs_bytag`	Metadata	`tags/songs`	`sortType, offset, count`	shelf, grid, verticallist	Y
Trending Playlists	`playlists_trending`	Metadata	`playlists/trending`	`type, offset, count`	shelf, grid, verticallist	N
Recommended Playlists	`playlists_recommended`	Services	`users/me/recommendedplaylists`	`offset, count`	shelf, grid, verticallist	Y
Tagged Discover	`discover_bytag`	Metadata	`tags/multiple`	`names`	shelf, grid	N
Tagged Podcasts	`podcasts_bytag`	Metadata	`tags/podcasts`	`tag, offset, count`	shelf, grid, verticallist	Y
Tagged Audiobooks	`audiobooks_bytag`	Metadata	`tags/audiobooks`	`tag, offset, count`	shelf, grid, verticallist	Y
Tagged Users	`users_bytag`	Services	`users/verified`	`tags`	shelf	N
Podcast New	`podcasts_new`	Metadata	`podcasts/new`	`from, offset, count`	shelf, grid, verticallist	Y
Podcasts Hosts	`podcasts_authors`	Metadata	`podcasts/authors`	`offset, count`	shelf, grid, list, verticallist	Y
Audiobooks New	`audiobooks_new`	Metadata	`audiobooks/new`	`offset, count`	shelf, grid, verticallist	Y
Audiobooks Authors	`audiobooks_authors`	Metadata	`podcasts/authors`	`offset, count`	shelf, grid, list, verticallist	Y
User Artists	`user_artists`	Services	`collection/followedartists`	`offset, count, userId`	shelf, grid, list, verticallist	N
User Albums	`user_albums`	Services	`collection/releases`	`offset, count, userId`	shelf, grid, verticallist	N
User Mixes	`user_mixes`	Services	`collection/stations`	`offset, count, userId`	shelf	N
User Podcasts	`user_podcasts`	Services	`collection/fav-podcasts`	`offset, count, userId`	shelf	N
User Audiobooks	`user_audiobooks`	Services	`collections/audiobooks`	`offset, count, userId`	shelf	N
Playlist Onboarding	`playlists_onboardingtags`	Services	`playlists/onboarding-tag-preferences`	`offset, count`	shelf, grid, verticallist	Y
Trending Tagged Playlists	`playlists_bytagtype`	Services	`playlists/trending-by-tagType`	`offset, count, tagType`	shelf, grid, verticallist	Y
Live Broadcast Live	`livebroadcast_live`	Metadata	`live-channels/%@/shows`	`channelId`	shelf, verticallist	Y
Live Broadcast Upcoming	`livebroadcast_upcoming`	Metadata	`live-channels/%@/shows`	`channelId`	shelf

Security Model

API Key Authentication

Header Parameters

StoreIdstring Required

API Key provided by Tuned Global for accessing the service

Path Parameters

contentkeystring Required

The unique content key, e.g. "new_albums"

Response

200

Object

Holds the flattened block layout for the page (spacing/album/etc. blocks). Decode it client-side before rendering.

Response Attributes

ContentIdinteger

Returns the content Id

ContentKeystring

Returns the content key as a unique text

Versioninteger

Returns the version of the content i.e v1.0

IsPublishedboolean

If content is published, returns Y to mean yes, otherwise N to mean no

Valuestring

Returns the value of the content

DateCreatedstring

Returns the date the content was created

DateUpdatedstring

Returns the date the content was updated

AllowShareboolean

Evaluates whether the content allows sharing

IncludeActivityFeedboolean

Evaluates whether the content includes activity feed

Countriesarray

Returns a list of countries the content exists in

Show child attributes

ContentTypeIdinteger

Returns the Id for the type of content

ContentTypestring

Returns the catagory of the content

ContentNamestring

Returns the name of the content

Typestring

Returns the type of content

404

Object

No content found for the given content key.

Sections

Content Get

Content Component Types

Security Model

Header Parameters

Path Parameters

ResponseExpand all

Response Attributes

Response

Response