Purpose

This simple API allows you to fetch any data related to the music on jamendo. It is read-only.

Things you can query with this API : albums, artists, tracks, users, tags, playlists, reviews, ...

Examples

todo, more examples.

Option reference

TARGETUNIT

TARGETUNIT is the type of the items you will get back. Valid values are :

album
track
artist
review (experimental)
user (experimental)
tag (experimental)

For instance, when loading a playlist, TARGETUNIT will be "track". But if you want to find all the artists that meet some criteria, it will be "artist".

LOADMETHOD

LOADMETHOD is the method we'll use to load the data. Valid values are :

id
list
search
tag
recom
name

For instance, with "id" you'll have to give a list of IDs you want to load, with "search" you'll have to give a search term, and with "recom" you'll get the music recommendations for the current user. More on this in the "Details" section.

PARAMUNIT

PARAMUNIT is the unit of the parameters you use. Valid values :

album
track
artist

PARAMUNIT is different from TARGETUNIT. It's the unit of the parameters you use. For instance, you can get the albums of an artist with TARGETUNIT=album and PARAMUNIT=artist (provided you give the artist name). Or you can see which album a track is from with PARAMUNIT=track and ITEMUNIT=album.

TARGET

TARGET can be any of :

p2p
page
id
audio
none
title
desc1
archivesrestricted
name
artworkurl
desc3

Target is the content you are looking for. For a list of IDs use TARGET=id. For a playlist use TARGET=audio.

FORMAT

FORMAT is the format of the data you want. Valid values are :

plain
rss2
json
podcast
play
xspf
ram
smil
pls
m3u
(xmlrpc)
ahah
redirect
phpserialized

That's a big list of formats and we're looking forward to get your ideas on new ones.

Details

Jamendo IDs

There are 3 different types of IDs on jamendo :

album IDs : Numeric, you can see them in the URLs of the albums : For album 33 the URL is http://www.jamendo.com/album/33/
track IDs : Numeric, you can see them in the URLs of the streams.
artist IDs : Numeric, they are invisible in the jamendo website because we use artist names instead in the URLs.

Artist IDs / Names / Dispnames

Artist IDs : See above
Artist Names : Unique string, with no special characters ([0-9^a-z.-]). They are used in the URLs (for instance : http://www.jamendo.com/artist/both/ for the artist with name "both").
Artist Dispnames : The "real" artist name, not unique. Most often it's the same as above, but it can be competely different.

Examples of id / name / dispname :

22 / acoustic.affinites / Acoustic Affinités
5 / both / Both

Primary Params vs Secondary Params

Primary params are parameters present in the path of the request. PARAMUNIT, LOADTYPE, etc... are primary params. Other primary params can be necessary with some options. We'll detail them below.

Secondary params are present in the query. They have no specific order and are a key/value pair. For instance, "order=release_date_desc" and "tag=ambient" are secondary params. They will be used in a request like this one :

http://www.jamendo.com/get/album/list/album/page/plain/?order=release_date_desc&tag=ambient

Redirections

Any application implementing this API should be ready to follow HTTP redirections.

List of audio encodings

The valid values for the secondary params "aue" and "are" are :

"ogg1" : lowfi OGG (q-1)
"ogg2" : lowfi OGG q4
"ogg3" : hifi OGG q7
"mp31" : lowfi MP3 (96kbits) (default for streaming / player)
"mp32" : hifi MP3 (200kbits+) (default for archives)

Please note that currently you can only use the lowfi for streaming and the hifi in the P2P archives.

Some incompatible options

There are a few dead ends in the API. For instance, you can't use TARGETUNIT=artist and TARGET=p2p, because we don't have per-artist archives. With TARGET=p2p currently you must use TARGET=album.

Same thing for TARGET=audio.. TARGETUNIT must be "track".

XMLRPC entry point

You can query the Music API with XMLRPC at this address : http://www.jamendo.com/xmlrpc/

There is only one method : '''array jamendo.get(string primaryparams, struct secondaryparams)'''

primaryparams is the "TARGETUNIT/LOADMETHOD/PARAMUNIT/TARGET/FORMAT/..." string you know from the API urls.
secondaryparams is a struct with the params that you would pass in the url, for instance "?order=xxx&tag=yyy" will become {"order":"xxx","tag":"yyy"} in an xmlrpc struct.

Please set TARGET to "xmlrpc". you can test queries in your brower with this format, too.

For instance, a query to : http://www.jamendo.com/get/track/id/album/audio/xmlrpc/33+45/?audio_encoding=ogg2

translates to this XMLRPC request : '''jamendo.get("track/id/album/audio/xmlrpc/33+45/",{"audio_encoding":"ogg2"})'''

Special cases

In this section we'll highlight several interesting options that require some additional parameters.

LOADTYPE = "id"

Use this option to get data associated to IDs you already know. Several IDs can be fetched in a new primary param, separated by "+" (equivalent to spaces in the urls)

For instance, if you want to get the albums of the groups with ids "both" and "triface" :

http://www.jamendo.com/get/album/id/artist/page/plain/both+triface/

LOADTYPE = "list"

This one is the most complicated. Use it to get a list of data with some optional secondary params :

'''o''' : the order. can be one of : rating_desc (global popularity, default),user_rating_desc (for the logged user, best reviews), user_recw_desc (recommendations), needseeding, rating_week_desc, release_date_desc, id_desc, public_date_desc, alpha_desc, needreviews, random
'''username''' : the username for user_rating_desc or user_recw_desc
'''n''' : the number of items to fetch
'''pn''' : the page number. default to 1. The items will be fetched in the range (n*(pn-1)) to (n*pn).
'''l''' : A 3-letter ISO country code.
'''tag''' : a jamendo tag
'''aclass''' : album class. "2" for long albums, "3" for short albums. You can fetch both with "2,3"
'''cani''' : rights on the music. "c" for allowed commercial use, "d" for allowed derivatives, "cd" for both
'''subset''' : user_dl (albums previously downloaded), user_listened (albums listened to), user_star (starred albums), user_lowfi (listened in stream), user_notlistened, user_recom, user_view (albums viewed on jamendo.com/album/xxx/)
'''subset_user_id''' : user_id for the subsets above
todo, complete this list

LOADTYPE = "recom"

Use this to get the music recommendations for the user currently logged. You'll need to use the jamendo cookie authentification. It adds a "n=xx" secondary parameter where xx is the number of recommendations you want to fetch.

LOADTYPE = "tag"

This is an alias for LOADTYPE=list with a secondary param tag=xxx.

For instance,

http://www.jamendo.com/get/album/tag/album/page/plain/electronica

is the same as

http://www.jamendo.com/get/album/list/album/page/plain/?tag=electronica

TARGET = "audio"

This will target to our http audio files. It adds the secondary param "aue=xxx" where xxx is the name of the audio encoding (see above).

TARGET = "p2p"

This will target our P2P archives. It will point to to a torrent file or to an ed2k link. It adds the secondary params "p2pnet" and "are".

"p2pnet" can be "torrent" (default) or "ed2k".

"are" is the archive audio encoding. (see formats above)

TARGET = "artworkurl"

This will target the cover of an album/track. TODO artist images. It adds the secondary params "artwork_size" and "artwork_id".

"artwork_size" is an integer (the covers are available for 70,100,130,200,300,400, etc.... if you want a custom one mail us.)

TARGET = "data"

todo

FORMAT = "play"

This one is an alias for the default playlist format of the currently logged user. It defaults to "m3u". It is widely used on the jamendo.com website.

Data Model = <pre>

One to One : ------ One to Many : -----* Many to Many : ----

Concert ----- Artist ----- User

Review ---- Album ------ Tag ------- User

User | |

* License ------* Track ------ Playlist *-------User

</pre>

MusiclistApi

Plateforme n°1 de musique libre. Téléchargement gratuit et légal pour usage privé - Licences pour usage commercial. Plus de 40.000 albums d'artistes originaux.

Purpose

Examples

Get all the albums of the artist named "both"

Get the name of the album with ID 116

Get the album that contains the track with ID 2000

Get all the tracks from the album with ID 33

Get them in the default playlist format

Get the tracks with IDS 2000 and 2001 in the XSPF playlist format

Get the 47 latest albums with the tags 'rock' and 'pop'

Get some informations about the albums with ID 116 and 33, in JSON

Get a list of all the jamendo album IDs

Get the RSS feed of the latest albums you can use commercially

Get a RSS feed of the latest torrent links in Ogg Vorbis

Get the cover of the album 116

GET a list of all Albums with Tag "ROCK"

GET a list of all Tags of the album 33