close
The Wayback Machine - https://web.archive.org/web/20140813151013/https://developer.beatsmusic.com/docs/read/getting_started/Public_Resources

Public Resources

If a Beats Music API is publicly available, you only need to provide your client ID in your API requests:

curl https://partner.api.beatsmusic.com/v1/api/tracks?client_id=[YOUR_CLIENT_ID]

Example

For example, using only your client ID, you can use our public Search API to find artists, tracks, albums, playlists, and users in the Beats Music Catalog. The general form of this API is:

curl -X GET 
"https://partner.api.beatsmusic.com/v1/api/search?
q=[YOUR_QUERY_STRING]
&type=[artist|genre|album|track|playlist|user]
&client_id=[YOUR_CLIENT_ID]"

In this example, we want to search for all tracks whose metadata contain the words "Blood on the Tracks", so we supply the query string, the type, and the client ID:  

curl -X GET 
"https://partner.api.beatsmusic.com/v1/api/search?
type=track
&q=blood+on+the+tracks
&client_id=mwfsu49zprp6rbcv4pfrux54"

The results contain tracks whose metadata contain those words:

{
    "data": [
        {
            "type": "search_result",
            "result_type": "track",
            "id": "tr56470885",
            "display": "Blood On The Tracks",
            "detail": "Phantom Creeps",
            "related": {
                "ref_type": "album",
                "id": "al56470855",
                "display": "Hellbilly Rebel Fire"
            }
        },
        {
            "type": "search_result",
            "result_type": "track",
            "id": "tr5898589",
            "display": "Here Today, Gone Tomorrow",
            "detail": "Blood On The Tracks",
            "related": {
                "ref_type": "album",
                "id": "al5898587",
                "display": "Blood On The Tracks"
            }
        },
        {
            "type": "search_result",
            "result_type": "track",
            "id": "tr51760477",
            "display": "Blood On The Tracks",
            "detail": "Michael Gray",
            "related": {
                "ref_type": "album",
                "id": "al51760469",
                "display": "Bob Dylan Encyclopedia Greatest Hits"
            }
        },
        ...
    ],
    "info": {
        "offset": 0,
        "count": 20,
        "total": 20
    },
    "code": "OK"
}

Docs Navigation