Editors Picks
You can get a list of editor picks of tracks and albums within the Genres in Find It in the Beats Music app.
Endpoint URL
/api/genres/:id/editors_picks
HTTP Method
GET
Authentication
Client ID required. See how to authenticate public resources here.
Parameters
| Name | Required | Description | Example |
|---|---|---|---|
| limit | optional | Specifies the maximum number of records to retrieve. The number of results returned will be less than or equal to this value. No results are returned if it is set to zero or less. The maximum permitted value is 200. If a value higher than 200 is specified, no more 200 results will be returned. Default 20. | 20 |
| offset | optional | A zero-based integer offset into the results. Default 0. | 0 |
Response Elements
| Response | Description |
|---|---|
| code |
Beats API response code. OK if successful; otherwise an error code is returned. error code.
|
| info |
Contains paging information used to display the results. |
| offset |
A zero-based integer offset into the results. Default 0. |
| count |
The number of results returned for this request. |
| total |
The total number of elements available for this resource. |
| data |
Data is a top level container for the returned list of tracks and albums. Each element is either an album or track object, and the objects are returned in the order in which they were added. |
| Album: | |
|
type |
The entity type of the API object. |
|
id |
The unique ID of the album. |
|
title |
The title of the album (including remarks indicating the edition). |
|
artist_display_name |
A string representing the name to display as the artist credit. |
|
duration |
Total duration of the audio, in seconds. |
|
parental_advisory |
Indicates whether the item has a parental advisory (explicit) warning. |
|
edited_version |
Indicates whether the item has is an edited version of an explicit song. song.
|
|
popularity |
The current projected popularity, relative to other items of the same type. |
|
release_date |
The release date of the album, in W3C DTF format: YYYY{-MM{-DD}} (see http://www.w3.org/TR/NOTE-datetime). Contains the year, with optional month and day. |
|
streamable |
Indicates whether at least one of the tracks on the album is streamable for the currently logged-in user. |
|
total_tracks |
The total number of tracks. |
|
essential |
This is one of the associated artist’s essential albums. |
|
refs |
Object with keys corresponding to referenced object types, and values providing the information needed for linking to the objects. |
| Track | |
|
type |
The entity type of the API object. |
|
id |
The unique ID of the track. |
|
title |
The title of the song corresponding to this track (including remarks indicating the version). |
|
artist_display_name |
A string representing the name to display as the artist credit. |
|
duration |
The total duration of the audio, in seconds. |
|
parental_advisory |
Indicates whether the item has a parental advisory (explicit) warning. |
|
edited_version |
Indicates whether the item has is an edited version of an explicit song. |
|
popularity |
The current projected popularity, relative to other items of the same type. |
|
track_position |
The position of the track in the album’s ordered track sequence, starting from 1. If the album is multi-disc, only the first track of the first disc starts from one – the others start from where the previous disc left off. |
|
disc_number |
If the track is from a multi-disc album, the disc number on which this track appears; otherwise 1. |
|
streamable |
Indicates whether the currently logged-in user has rights to stream the track. |
|
refs |
Object with keys corresponding to referenced object types, and values providing the information needed for linking to the objects. |
Example Request
curl -X GET https://partner.api.beatsmusic.com/v1/api/genres/eg97074088215970048/editors_picks?
client_id=[CLIENT_ID]Example Response
{
data: [
{
type: "album",
id: "al31397897",
title: "Soul Food",
duration: 3662,
parental_advisory: true,
edited_version: false,
release_date: "1995-11-07",
release_format: "LP",
rating: 0,
popularity: 26482,
streamable: true,
artist_display_name: "Goodie Mob",
refs: {
artists: [
{
ref_type: "artist",
id: "ar12541",
display: "Goodie Mob"
}
],
label: {
ref_type: "label",
id: "lb500565",
display: "Arista/LaFace Records"
},
tracks: [
{
ref_type: "track",
id: "tr31397899",
display: "Free"
},
...
{
ref_type: "track",
id: "tr31413695",
display: "The Day After"
}
]
},
canonical: true,
total_companion_albums: 0,
total_tracks: 19,
essential: true
},
...
],
info: {
offset: 0,
count: 3,
total: 3
},
code: "OK"
}
