API Doc

• Overview
• User Authentication
• Submissions
• Playlists
• Downloads
• REST requests
• XML-RPC requests

API Methods

• Album
• album.addTags
• album.getInfo
• album.getTags
• album.removeTag
• album.search
• Artist
• artist.addTags
• artist.getEvents
• artist.getInfo
• artist.getSimilar
• artist.getTags
• artist.getTopAlbums
• artist.getTopFans
• artist.getTopTags
• artist.getTopTracks
• artist.removeTag
• artist.search
• artist.share
• Auth
• auth.getMobileSession
• auth.getSession
• auth.getToken
• auth.getWebSession
• Event
• event.attend
• event.getInfo
• event.share
• Geo
• geo.getEvents
• geo.getTopArtists
• geo.getTopTracks
• Group
• group.getWeeklyAlbumChart
• group.getWeeklyArtistChart
• group.getWeeklyChartList
• group.getWeeklyTrackChart
• Library
• library.addAlbum
• library.addArtist
• library.addTrack
• library.getAlbums
• library.getArtists
• library.getTracks
• Playlist
• playlist.addTrack
• playlist.create
• playlist.fetch
• Tag
• tag.getSimilar
• tag.getTopAlbums
• tag.getTopArtists
• tag.getTopTags
• tag.getTopTracks
• tag.getWeeklyArtistChart
• tag.getWeeklyChartList
• tag.search
• Tasteometer
• tasteometer.compare
• Track
• track.addTags
• track.ban
• track.getInfo
• track.getSimilar
• track.getTags
• track.getTopFans
• track.getTopTags
• track.love
• track.removeTag
• track.search
• track.share
• User
• user.getEvents
• user.getFriends
• user.getInfo
• user.getLovedTracks
• user.getNeighbours
• user.getPastEvents
• user.getPlaylists
• user.getRecentTracks
• user.getRecommendedEvents
• user.getTopAlbums
• user.getTopArtists
• user.getTopTags
• user.getTopTracks
• user.getWeeklyAlbumChart
• user.getWeeklyArtistChart
• user.getWeeklyChartList
• user.getWeeklyTrackChart

Overview

The Last.fm API allows you to call methods that respond in REST style xml. Individual methods are detailed in the menu on the left.

Generally speaking, you will send a method parameter expressed as 'package.method' along with method specific arguments to the root URL. The API supports multiple transport formats but will respond in Last.fm idiom xml by default.

Note:

• Please use an identifiable User-Agent header on all requests. Like this you don't risk getting banned and it helps our logging.
• Use common sense when deciding how many calls to make. For example, if you're making a web application, try not to hit the API on page load. You account may be suspended if your application is continuously making several calls per second. See our terms of service for more.

Encoding

Use UTF-8 encoding when sending arguments to API methods.

Request Styles

You can get more information on how to work with REST requests or XML-RPC requests when calling the Last.fm API.

Authentication

The authentication protocol allows you to perform actions on user accounts in a manner that is secure for Last.fm users. All write services require authentication.

Submissions

You can use our submissions API to submit listening information to Last.fm user profiles (aka 'Scrobbling'). Useful for media players looking to integrate with Last.fm.

Discussion

Join the Last.fm Web Services group to receive notifications about new Web Services, access to beta API's, provide feedback and discuss development with other developers.