close
The Wayback Machine - https://web.archive.org/web/20140813140057/https://developer.beatsmusic.com/docs/read/artists/Playlists

Playlists

You can get a list of playlists associated with an artist.

Endpoint URL

/api/artists/:id/playlists

HTTP Method

GET

Authentication

Client ID required. See how to authenticate public resources here.

Parameters

Name Required Description Example
artist_id required The unique ID for the artist. ar3177282
fields optional An array of object fields to include in the response. Only the given fields will be retunred. Default is to return all fields.
offset optional A zero-based integer offset into the results. Default 0. 0
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
order_by optional Indicates how the results set should be sorted.
Values (default is popularity desc):
name asc Order alphabetically by name.
name Equivalent to name asc.
name desc Sort in in reverse alphabetical order by name.
created_at asc Sort in ascending order by creation date (created_at).
created_at Equivalent to created_at asc.
created_at desc Sort in in reverse order by creation date (created_at).
updated_at asc Sort in ascending order by update date (updated_at).
updated_at Equivalent to updated_at asc.
updated_at desc Order reverse by updated_at
duration asc Sort in ascending order by duration.
duration Equivalent to duration asc.
duration desc Sort in in reverse order by duration.
total_tracks asc Sort in ascending order bytotal_tracks.
total_tracks Equivalent to total_tracks asc.
total_tracks desc Sort in in reverse order by total_tracks.
popularity
 

Response Elements

code

Beats API response code. OK if successful; otherwise an error code is returned.
data

List of playlists. Each element is a playlist object:

type

The entity type of the API object.

id

The unique ID of the track.

name

The name of the playlist.

description

The description of the playlist.

user_display_name

The name to use when displaying the playlist's author.

total_tracks

The number of tracks on the album, including unstreamable tracks.

total_subscribers

The number of users subscribed to the playlist.

duration

Total duration of the audio, in seconds.

created_at

Epoch creation timestamp for the playlist.

updated_at

Epoch timestamp for the last update of the playlist.

parental_advisory

Indicates whether the item has a parental advisory (explicit) warning.

refs

Object with keys corresponding to referenced object types, and values providing the information needed for linking to the objects.
ref_type
The API object type of the referenced item.
id
The unique ID of the referenced item.
display
Text to be displayed when displaying a link to the referenced item.

Example Request

Suppose you wereinterested in retrieving all playlists associated with Dr. Dre. You used the Search API to search the Beats Music Catalog for that artist, and the following information was returned:

{
   "data":[
      {
            "type": "search_result",
            "result_type": "artist",
            "id": "ar3177282",
            "display": "DR.DRE",
         ...
      },
      ...
   ],
   ...
   "code":"OK"
}

You can use the artist ID (ar3177282) to retrieve a list of playlists associated with that artist. The general form of this API is:

curl -X GET "https://partner.api.beatsmusic.com/v1/api/artists/[ARTIST_ID]/playlists?
    client_id=[YOUR_CLIENT_ID]"

In this example we will retrieve the playlists associated with Dr. Dre. You will need to specify the artist ID (ar3177282) and your client ID:

curl -X GET "https://partner.api.beatsmusic.com/v1/api/artists/ar3177282/playlists?
    client_id=[YOUR_CLIENT_ID]"

Example Response

{
    "data": [
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl149552683043258624",
            "display": "Dr. Dre: Production Deep Cuts",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl149552683043258624",
                "display": "Dr. Dre: Production Deep Cuts"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl110088624602743296",
            "display": "Partners In Rhyme: Snoop Dogg and Dr. Dre",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl110088624602743296",
                "display": "Partners In Rhyme: Snoop Dogg and Dr. Dre"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl2740183",
            "display": "Behind the Boards: Dr. Dre",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl2740183",
                "display": "Behind the Boards: Dr. Dre"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl2740767",
            "display": "Partners In Rhyme: Dr. Dre and Eminem",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl2740767",
                "display": "Partners In Rhyme: Dr. Dre and Eminem"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl97825532049228288",
            "display": "Intro to Xzibit",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl97825532049228288",
                "display": "Intro to Xzibit"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl101452503287202560",
            "display": "Guest List: Dr. Dre",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl101452503287202560",
                "display": "Guest List: Dr. Dre"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl95370384404250880",
            "display": "Intro to Mac Dre",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl95370384404250880",
                "display": "Intro to Mac Dre"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl2528607",
            "display": "Intro to Dr. John",
            "detail": "Beats Soul/Funk",
            "related": {
                "ref_type": "playlist",
                "id": "pl2528607",
                "display": "Intro to Dr. John"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl2461981",
            "display": "Intro to Dr. Dog",
            "detail": "Beats Alternative",
            "related": {
                "ref_type": "playlist",
                "id": "pl2461981",
                "display": "Intro to Dr. Dog"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl116326389480817408",
            "display": "Guest List: Devin the Dude",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl116326389480817408",
                "display": "Guest List: Devin the Dude"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl82596746227613696",
            "display": "Dr. John: The Night Tripper Era",
            "detail": "Beats Soul/Funk",
            "related": {
                "ref_type": "playlist",
                "id": "pl82596746227613696",
                "display": "Dr. John: The Night Tripper Era"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl132163040467616512",
            "display": "Raise the Bar",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl132163040467616512",
                "display": "Raise the Bar"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl2741173",
            "display": "Best of Aftermath Entertainment, Vol.1",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl2741173",
                "display": "Best of Aftermath Entertainment, Vol.1"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl91761667976856320",
            "display": "Behind the Boards: Alex Da Kid",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl91761667976856320",
                "display": "Behind the Boards: Alex Da Kid"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl133610024693007104",
            "display": "S. Carter: Ghostwriter",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl133610024693007104",
                "display": "S. Carter: Ghostwriter"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl149924125383589888",
            "display": "N.W.A's Essential Solo Cuts",
            "detail": "XXL Magazine",
            "related": {
                "ref_type": "playlist",
                "id": "pl149924125383589888",
                "display": "N.W.A's Essential Solo Cuts"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl133345265045340928",
            "display": "Best of Compton Hip-Hop",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl133345265045340928",
                "display": "Best of Compton Hip-Hop"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl122220608053445120",
            "display": "Producers on the Mic",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl122220608053445120",
                "display": "Producers on the Mic"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl140949120725549056",
            "display": "Beats Music Launch Party Mix",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl140949120725549056",
                "display": "Beats Music Launch Party Mix"
            }
        },
        {
            "type": "search_result",
            "result_type": "playlist",
            "id": "pl107534327755178496",
            "display": "Nas: Concept Songs",
            "detail": "Beats Hip-Hop",
            "related": {
                "ref_type": "playlist",
                "id": "pl107534327755178496",
                "display": "Nas: Concept Songs"
            }
        }
    ],
    "info": {
        "offset": 0,
        "count": 20,
        "total": 6503
    },
    "code": "OK"
}

version 9 as of 3 months ago by Robin

Docs Navigation