Using the API

MusicBrainz

Cloudspeakers tries to match all found reviews, audio and video files to the MusicBrainz database. MusicBrainz is a community music metadatabase that attempts to create a comprehensive music information site.
To request data from an artist (or album) you need the MusicBrainz UUID of that artist (or album)
Other calls to get data from a user, source or reviewer you need the username or source name.

Examples

Below you find some examples of how to request the data. See the detailed documentation for each call for the parameters and their meaning.

Getting a playlist of audio and video about artist 'Animal Collective' in XML (XSPF) format

http://api.cloudspeakers.com/2.0/playlists/artist/0c751690-c784-4a4f-b1e4-c1de27d47581.xml

<?xml version="1.0" encoding="UTF-8" ?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
    <title>Cloudspeakers playlist for Animal Collective</title>
    <info>http://www.cloudspeakers.com/en/artists/Animal-Collective/0c751690-c784-4a4f-b1e4-c1de27d47581</info>
    <apiversion>2.0</apiversion>
    <date>Thu, 08 Oct 2009 17:07:20 +0200</date>
    <trackList>
        <item>

            <title><![CDATA[Summertime Clothes (Dam-Funk remix)]]></title>
            <annotation><![CDATA[Animal Collective
    audio - Stereogum]]></annotation>
            <creator><![CDATA[Animal Collective]]></creator>
            <info>http://www.cloudspeakers.com/en/artists/Animal-Collective/0c751690-c784-4a4f-b1e4-c1de27d47581</info>
            <location><![CDATA[http://stereogum.com/mp3/Animal%20Collective%20-%20Summertime%20Clothes%20(Dam-Funk%20Remix).mp3]]></location>
            <type>mp3</type>
            <image>http://s3.cloudspeakers.com/img/videoplayer-img.png</image>

            <created>2009-07-08 07:35:27</created>
        </item>
        <item>
            <title><![CDATA[Fireworks]]></title>
            <annotation><![CDATA[Animal Collective
    video - Breakfast On Tour]]></annotation>
            <creator><![CDATA[Animal Collective]]></creator>
            <info>http://www.cloudspeakers.com/en/artists/Animal-Collective/0c751690-c784-4a4f-b1e4-c1de27d47581</info>
            <location><![CDATA[http://www.youtube.com/watch?v=7vaJuQ2NeFA]]></location>

            <type>flv</type>
            <image>http://img.youtube.com/vi/7vaJuQ2NeFA/0.jpg</image>
            <created>2009-06-18 07:15:28</created>
        </item>
        <item>...</item>
    </trackList>
</playlist>

Getting the hottest artists in JSON format


http://api.cloudspeakers.com/2.0/hotlists/artists.json

{
    "hotlist":
    [
        {
            "Artist":
            {
                "gid":"ada7a83c-e3e1-40f1-93f9-3e73dbc9298a",
                "name":"Arctic Monkeys",
                "rank":1
            }
        },
        {
            "Artist":
            {
                "gid":"9c9f1380-2516-4fc9-a3e6-f9f61941d090",
                "name":"Muse",
                "rank":2
            }
        },
        {...}
    ]
}

Comments