Featured
You can retrieve the current Featured content, which has been selected by Beats Music editors.
Endpoint URL
/api/discoveries/featured
HTTP Method
GET
Authentication
Client ID required. See how to authenticate public resources here.
Parameters
n/a
Response Elements
| Response | Description |
|---|---|
| code | Beats API response code. OK if successful; otherwise an error code is returned. |
| data | List of recommendations selected by Beats Music editors (albums, tracks, playlists). |
Example Request
Suppose you would like to retrieve the Featured content in the Beats Music collection. The general form of this API is:
curl -X GET "https://partner.api.beatsmusic.com/v1/api/discoveries/featured?
client_id=[YOUR_CLIENT_ID]"Example Response
{
"data": [
{
"type": "recommendation",
"content": {
"type": "album",
"id": "al75517341",
"title": "For My Thugz (Parental Advisory)",
"duration": 3833,
"parental_advisory": true,
"edited_version": false,
"release_date": "2003-08-19",
"release_format": "LP",
"rating": 0,
"popularity": 19343,
"streamable": true,
"artist_display_name": "Lil' Boosie",
"refs": {
"artists": [
{
"ref_type": "artist",
"id": "ar131803",
"display": "Lil' Boosie"
}
],
"label": {
"ref_type": "label",
"id": "lb1076513",
"display": "Trill Entertainment, LLC"
},
"tracks": [
{
"ref_type": "track",
"id": "tr75517343",
"display": "Gangsta Sh*t"
},
{
"ref_type": "track",
"id": "tr75517345",
"display": "How You Feel"
},
{
"ref_type": "track",
"id": "tr75517347",
"display": "My Ni**a Then"
},
{
"ref_type": "track",
"id": "tr75517349",
"display": "Bucked Up"
},
...
]
},
"canonical": true,
"total_companion_albums": 0,
"total_tracks": 16,
"essential": false
},
"blurb": [
""
]
},
{
"type": "recommendation",
"content": {
"type": "album",
"id": "al99909989",
"title": "Beating Heart",
"duration": 212,
"parental_advisory": false,
"edited_version": false,
"release_date": "2014-03-05",
"release_format": "Single",
"rating": 0,
"popularity": 0,
"streamable": true,
"artist_display_name": "Ellie Goulding",
"refs": {
"artists": [
{
"ref_type": "artist",
"id": "ar878610",
"display": "Ellie Goulding"
}
],
"label": {
"ref_type": "label",
"id": "lb1513664",
"display": "Lionsgate/Divergent Score"
},
"tracks": [
{
"ref_type": "track",
"id": "tr99909991",
"display": "Beating Heart"
}
]
},
"canonical": true,
"total_companion_albums": 0,
"total_tracks": 1,
"essential": false
},
"blurb": [
""
]
},
{
"type": "recommendation",
"content": {
"type": "playlist",
"id": "pl1950149",
"name": "Intro to Belle & Sebastian",
"description": "When Belle and Sebastian ...",
"user_display_name": "Beats Indie",
"access": "public",
"duration": 6480,
"total_tracks": 25,
"total_subscribers": 84,
"created_at": 1348099200,
"updated_at": 1394012479,
"parental_advisory": false,
"refs": {
"tracks": [
{
"ref_type": "track",
"id": "tr20925239",
"display": "The State I’m In"
},
{
"ref_type": "track",
"id": "tr20925325",
"display": "Seeing Other People"
},
{
"ref_type": "track",
"id": "tr20925357",
"display": "The Fox in the Snow"
},
...
],
"user": {
"ref_type": "genre",
"display": "beatsindie",
"id": "eg77531656583380992"
},
"author": {
"ref_type": "user",
"display": "Scott Plagenhoef ",
"id": "61279522292498432"
}
}
},
"blurb": [
""
]
},
{
"type": "recommendation",
"content": {
"type": "playlist",
"id": "pl109372430761460480",
"name": "Beats Music: From the Vaults",
"description": "Some of the best ...",
"user_display_name": "Beats Classic Rock",
"access": "public",
"duration": 3089,
"total_tracks": 15,
"total_subscribers": 144,
"created_at": 1383074819,
"updated_at": 1394012478,
"parental_advisory": false,
"refs": {
"tracks": [
{
"ref_type": "track",
"id": "tr97390379",
"display": "Don't Keep Me Wondering"
},
{
"ref_type": "track",
"id": "tr96380285",
"display": "Dallas"
},
{
"ref_type": "track",
"id": "tr95833427",
"display": "I Got My Mojo Working"
},
...
],
"user": {
"ref_type": "genre",
"display": "beatsclassicrock",
"id": "eg97079905791115776"
},
"author": {
"ref_type": "user",
"display": "mason williams",
"id": "61550958911422464"
}
}
},
"blurb": [
""
]
}
],
"info": {
"offset": 0,
"count": 4,
"total": 4
},
"code": "OK"
}
