Librefm API¶

Submitting Tracks¶

libre.fm is working towards support for the scrobbling API

Getting At Your Data¶

Syntax: RDFa¶

RDFa is currently being deployed across libre.fm's pages. This means you can use a RDFa reader to extract raw data straight from libre.fm's pages without having to resort to complicated and unreliable scraping.

If you would prefer the data in another format, libre.fm has a server-side on-the-fly RDFa converter. To get a JSON copy of the data on http://alpha.libre.fm/user/tobyink/groups, just request the following URL:

http://alpha.libre.fm/rdf.php?fmt=json&page=/user/tobyink/groups

Formats offered are:

• xml - RDF/XML data
• json - JSON (supports a "callback" parameter)
• rss - RSS-1.0-compatible RDF/XML.
• ttl - Turtle
• nt - N-Triples

Vocabularies Used¶

Primarily:

• FOAF
• Music Ontology
• RSS 1.0
• DCMI Metadata Terms
• Event Ontology

API cheat sheet¶

An incomplete quick reference to the implemented API methods
add format=json to url if you want that instead of XML

Album		Requires authenthication
album.addTags		yes
album.getTopTags	http://alpha.libre.fm/2.0/?method=album.gettoptags&artist=libre.fm&album=libre.fm	no
Artist
artist.addTags		yes
artist.getFlattr	http://alpha.libre.fm/2.0/?method=artist.getFlattr&artist=libre.fm	no
artist.getInfo	http://alpha.libre.fm/2.0/?method=artist.getinfo&artist=libre.fm	no
artist.getTopTracks	http://alpha.libre.fm/2.0/?method=artist.gettoptracks&artist=libre.fm	no
artist.getTopTags	http://alpha.libre.fm/2.0/?method=artist.gettoptags&artist=libre.fm	no
Track
track.addTags		yes
track.ban		yes
track.love		yes
track.unban		yes
track.unlove		yes
track.getTags		yes
track.getTopTags	http://alpha.libre.fm/2.0/?method=track.gettoptags&artist=libre.fm&track=libre.fm%20podcast%20april%202010	no
User
user.getBannedTracks	http://alpha.libre.fm/2.0/?method=user.getbannedtracks&user=kabniel&limit=5	no
user.getInfo	http://alpha.libre.fm/2.0/?method=user.getinfo&user=kabniel	no
user.getLovedTracks	http://alpha.libre.fm/2.0/?method=user.getlovedtracks&user=kabniel&limit=5	no
user.getNeighbours	http://alpha.libre.fm/2.0/?method=user.getneighbours&user=kabniel	no
user.getRecentTracks	http://alpha.libre.fm/2.0/?method=user.getrecenttracks&user=kabniel&page=1&limit=5	no
user.getTopTags	http://alpha.libre.fm/2.0/?method=user.gettoptags&user=kabniel&limit=5	no
user.getTopTracks	http://alpha.libre.fm/2.0/?method=user.gettoptracks&user=kabniel	no