Web Services

Please note that the new Last.fm API is now located at www.last.fm/api. The web services included below are still supported, but are considered legacy.

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 or contact RJ.

You can access the web services on ws.audioscrobbler.com up to once per second (this is calculated on an hourly average). If you're trying to do anything more than this, 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.

Licensing Caveats

If the data you are using was generated directly by you (ie. it is your profile data, recent tracks etc) then you can do whatever you want with it. Don't worry about any licensing restrictions.

If the data was generated by Last.fm, or other users of the site, then you must abide by the CC license above (or a commercial license from us).

If you have ads on the site you wish to use this data on, you might be wondering does that count as commercial use?. If the ads are barely covering your running costs, we consider that non-commercial. Actually we consider most stuff non-commercial. If you are making a healthy profit from your site, and using this data to enhance the site, that sounds commercial. Any queries, just get in touch with us.

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
Add ?type=<3month|6month|12month> for alternate charts 		Plain XML
Top Albums
50 most played albums from a music profile
Add ?type=<3month|6month|12month> for alternate charts 		Plain XML
Top Tracks
50 most played tracks from a music profile
Add ?type=<3month|6month|12month> for alternate charts 		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
System Recommendations
System Recommendations 		XML RSS
Current Events
Events that you have marked yourself as attending 		iCal RSS
Friends' Events
Events that your friends are attending 		iCal RSS
System Event Recommendations
Events from your dashboard that match your profile. 		iCal RSS
Taste-O-Meter
Similarity of this user to another user 		XML

Artist Data

Similar Artists
Related artists, based on various data sources 		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
Current Events
Events that an artist is marked as playing at 		iCal RSS

Album Data

Info
Information about the album, including track listing 		XML

Track Data

Similar Tracks
Related tracks, based on various data sources 		XML
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

Geo-aware Data

Top Artists
The most popular artists this week in a particular country 		XML
Top Tracks
The most popular tracks this week in a particular country 		XML