Web Services

Much of the data available to view on Last.fm is available in several formats through the Audioscrobbler Web Services API.

You are encouraged to update the wiki if you find a use for these webservices. If you find them laughably inadequate, or would like to offer updated templates (or even templates for another format) then please post in the forums.

Do not exceed one request per second to ws.audioscrobbler.com without prior arrangement, it will result in your IP being banned. If you're trying to do anything remotely high-traffic, we'd very much appreciate a heads-up first. We don't have infinite resources to support this. Either post in the forums or contact Russ.

Some nifty "Powered by Audioscrobbler" badges and other images suitable for linking purposes can be found here.

Licensing

All web services here are for non-commercial use only under the Creative Commons Attribution-NonCommercial-ShareAlike License. If you want to use these services in a commercial context you must contact partners at last dot fm first to get a seperate license.

Status

These web services are currently in beta. They are mostly finished, but we may have to make some final tweaks to them before we can declare them released.

Categories

User Profile Data

Profile Information
Information about the profile (eg: Name, Gender) 		XML
Top Artists
50 most played artists from a music profile 		Plain XML
Top Albums
50 most played albums from a music profile 		Plain XML
Top Tracks
50 most played tracks from a music profile 		Plain XML XSPF
Top Tags
Most used tags by a music profile 		Plain XML
Top Tags for Artist
Tags most used on a specific artist 		XML
Top Tags for Album
Tags most used on a specific album 		XML
Top Tags for Track
Tags most used on a specific track 		XML
Friends List
Friends added to this profile 		Plain XML
Neighbours
People with similar taste to this profile 		Plain XML
Recent Tracks
10 recently played tracks for this profile 		Plain XML XSPF RSS
Recent Banned Tracks
10 recently banned tracks for this profile 		XML XSPF
Recent Loved Tracks
10 recently loved tracks for this profile 		XML XSPF
Recent Journals
Recent journal entries for this profile 		RSS
Weekly Chart List
List of dates of available weekly charts for this profile 		XML
Recent Weekly Artist Chart
Most recent weekly artist chart 		XML
Recent Weekly Album Chart
Most recent weekly album chart 		XML
Recent Weekly Track Chart
Most recent weekly track chart 		XML
Previous Weekly Artist Chart
Select a weekly artist chart by date 		XML
Previous Weekly Album Chart
Select a weekly album chart by date 		XML
Previous Weekly Track Chart
Select a weekly track chart by date 		XML
Manual Recommendations
Recommendations manually sent to you 		RSS

Artist Data

Related Artists
People who listen to X also listen to A,B,C... 		Plain XML
Top Fans
Profiles who've listened to a given artist the most, i.e. the biggest fans. 		XML
Top Tracks
The most popular tracks by a given artist 		XML XSPF
Top Albums
The most popular albums by a given artist 		XML
Top Tags
The most popular tags applied to a given artist 		XML

Album Data

Info
Information about the album, including track listing 		XML

Track Data

Top Fans
Profiles who've listened to a given track the most, i.e. the biggest fans. 		XML
Top Tags
The most popular tags applied to a given track 		XML

Tag Data

Overall Top Tags
Most used tags overall 		XML
Top Artists
Artists tagged the most times with this tag 		XML
Top Albums
Albums tagged the most times with this tag 		XML
Top Tracks
Tracks tagged the most times with this tag 		XML XSPF

Group Data

Recent Journals
Journal posts recently in this group 		RSS
Weekly Chart List
List of dates of available weekly charts for this group 		XML
Recent Weekly Artist Chart
Most recent weekly artist chart 		XML
Recent Weekly Album Chart
Most recent weekly album chart 		XML
Recent Weekly Track Chart
Most recent weekly track chart 		XML
Previous Weekly Artist Chart
Select a weekly artist chart by date 		XML
Previous Weekly Album Chart
Select a weekly album chart by date 		XML
Previous Weekly Track Chart
Select a weekly track chart by date 		XML

Forum Data

Forums
RSS feed of recent forum posts in a specific forum 		RSS

LiveJournal Protocol

We currently support a subset of the Live Journal Protocol for uploading and querying journal posts.

Challenge authentication is not currently supported as we don't hold an un-hashed copy of the user's password so you'll have to make do with clear and cookie. I'm sure you'll survive but if this proves to be a huge problem let us know and we'll try to sort it out.

Only the dlat interface is supported, if enough people can give enough of a reason to support the XML-RPC interface we'll put it on our list but until then, we just don't support it.

Not all methods make sense in our context so below is a list of the methods that we support:

The URL for the interface is http://wsdev.audioscrobbler.com/interface/flat/