Lookup

You can retrieve a single artist from the collection of artists available in Beats Music.

Endpoint URL

/api/artists/:id

HTTP Method

GET

Authentication

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

Parameters

Name	Required	Description	Example
id	required	The unique ID of the artist.	ar1033754
fields	optional	An array of object fields to include in the response. Only the specified fields will be returned. Default is to return all fields.
refs	optional	An array of referenced objects to include in the response. Only the requested ref collections will be returned. Default is to return all refs. Values: similars.	similars

Response Elements

Response	Description
code	Beats API response code. OK if successful; otherwise an error code is returned.
data	List of artists matching the request. Each element is an artist object:
type	The entity type of the API object.
id	The unique ID of the artist.
name	A string representing the name to display as the artist credit. Example: Jay Z & Kanye West
popularity	The current projected popularity, relative to other items of the same type. Note: This does not necessarily reflect historic popularity of the item, as new items can be assigned high popularity based on projected demand.
streamable	Determines whether the the artist is streamable.
total_albums	The number of albums credited to this artist.
total_singles	The number of singles credited to this artist.
total_eps	The number of EPs credited to this artist.
total_lps	The number of LPs credited to this artist.
total_freeplays	The number of free plays credited to this artist.
total_tracks	The total number of tracks credited to this artist.
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 used the Search API to search the Beats Music Catalog for the artist Kendrick Lamar, and the following information was returned:

{
    "data": [
        {
            "type": "search_result",
            "result_type": "artist",
            "id": "ar1033754",
            "display": "Kendrick Lamar",
            "detail": "",
            "related": {
                "ref_type": "artist",
                "id": "ar1033754",
                "display": "Kendrick Lamar"
            }
        }
    ],
    "info": {
        "offset": 0,
        "count": 1,
        "total": 1
    },
    "code": "OK"
}

You can use the artist ID (ar1033754) to retrieve more detailed information about that artist. The general form of this API is:

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

In this example we will retrieve detailed information about Kendrick Lamar. You will need to specify the artist ID (ar1033754) and your client ID:

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

Example Response

{
    "data": {
        "type": "artist",
        "id": "ar1033754",
        "name": "Kendrick Lamar",
        "popularity": 1679361,
        "streamable": true,
        "total_albums": "17",
        "total_singles": "11",
        "total_eps": "0",
        "total_lps": "6",
        "total_freeplays": 0,
        "total_compilations": "0",
        "total_tracks": "169",
        "refs": {
            "similars": []
        },
        "verified": false,
        "total_follows": 0,
        "total_followed_by": 69103
    },
    "code": "OK"
}

version 6 as of 3 months ago by Robin

Jul	AUG	Sep
	13
2013	2014	2015