Web Service Endpoint

Get a Catalog Playlist's Relationship Directly by Name

Fetch a playlist's relationship by using its identifier.

URL

GET https://api.music.apple.com/v1/catalog/{storefront}/playlists/{id}/{relationship}

Path Parameters

id
string
(Required)

A unique identifier for the playlist.

relationship
string
(Required)

The name of the relationship you want to fetch for this resource.

storefront
string
(Required)

An iTunes Store territory, specified by an ISO 3166 alpha-2 country code. The possible values are the id attributes of Storefront objects.

Query Parameters

l
string

The localization to use, specified by a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefront object specified by storefront. Otherwise, the storefront’s defaultLanguageTag is used.

limit
number

The limit on the number of objects, or number of objects in the specified relationship, that are returned.

Response Codes

OK

The request was successful.

Discussion

If successful, the HTTP status code is 200 (OK) and the data array in the ResponseRoot object contains a single Playlist.Relationships object. If unsuccessful, the HTTP status code indicates the error and the details are in the errors array. See Handle a Response.

Example

https://api.music.apple.com/v1/catalog/us/playlists/pl.acc464c750b94302b8806e5fcbe56e17/curator
{ "data": [ { "attributes": { "artwork": { "bgColor": "fffffd", "height": 1080, "textColor1": "0a080a", "textColor2": "43281d", "textColor3": "3b393a", "textColor4": "69534a", "url": "https://example.mzstatic.com/image/thumb/Features7/v4/6b/9b/62/6b9b624b-bba4-83d4-8634-6b9fd7e2efc0/pr_source.png/{w}x{h}bb.jpeg", "width": 1080 }, "editorialNotes": { "short": "You\u2019re on the guest list. Dress to impress.", "standard": "R&amp;B is what happened when rhythm and blues got a glossy modern polish with distant echoes of disco and funk.&#xa0;Of course, it\u2019s sometimes hard to hear traces of either funk or disco in modern R&amp;B. And in fact, many 21st-century R&amp;B hits feel closer to dance-pop or hip-hop than classic soul music or vintage rhythm and blues. The story of contemporary R&amp;B really starts in the late \u201970s and early \u201980s, a time when several strains of African-American music began to mingle in innovative and unexpected ways. That was the era when innovators and future superstars like Prince and Rick James started to combine slickly futuristic synthesizer hooks and smooth disco rhythms with elements of traditional funk and soul, setting the template for the R&amp;B sound of the \u201980s and beyond.\n<br /><br />\nWith the release of <i>Thriller</i> in 1983, Michael Jackson took this hybrid style to mainstream heights, breaking sales records around the world and singlehandedly making R&amp;B one of the key ingredients in pop music for the next several decades. In the late \u201980s, singer and producer Teddy Riley coined the name \u201cnew jack swing\u201d to describe&#xa0;a&#xa0;funkier,&#xa0;party-ready&#xa0;brand of R&amp;B that was heavy on hip-hop style and attitude.&#xa0;By the&#xa0;\u201990s, rappers and R&amp;B singers were constantly collaborating&#xa0;on each other\u2019s songs. As MCs started rhyming over R&amp;B instrumentals and enlisting R&amp;B singers to sing the hooks, it gave hip-hop mainstream appeal. On the flip side, artists like Mary J. Blige led the charge to bring hip-hop beats into R&amp;B, which birthed hip-hop soul and further blurred the lines between the genres.&#xa0;Of course there\u2019s always been room for soulful ballads and slow jams in modern R&amp;B, as anyone who\u2019s swooned to a Mariah Carey or John Legend hit knows well. The late \u201990s saw the rise of the movement known as neo-soul, which abandoned the glitzy, synthetic sound of much modern R&amp;B for the kind of classic musicianship that had seemingly been swept away. Of course, the foundations of R&amp;B have always been built on innovation and the unexpected, and it keeps on evolving, whether you\u2019re looking for a club-ready banger from&#xa0;Beyonc\u00e9&#xa0;or an adventurous jam from D\u2019Angelo." }, "name": "Apple Music R&B", "url": "https://itunes.apple.com/us/curator/apple-music-r-b/976439551" }, "href": "/v1/catalog/us/apple-curators/976439551", "id": "976439551", "type": "apple-curators" } ]}

See Also

Requesting a Catalog Playlist

Get a Catalog Playlist

Fetch a playlist by using its identifier.

Get Multiple Catalog Playlists

Fetch one or more playlists by using their identifiers.