API Doc
- Overview
- User Authentication
- Submissions (Scrobbling)
- Radio API
- Playlists
- Downloads
- REST requests
- XML-RPC requests
API Methods
- Album
- Artist
- artist.addTags
- artist.getEvents
- artist.getImages
- artist.getInfo
- artist.getPastEvents
- artist.getPodcast
- artist.getShouts
- artist.getSimilar
- artist.getTags
- artist.getTopAlbums
- artist.getTopFans
- artist.getTopTags
- artist.getTopTracks
- artist.removeTag
- artist.search
- artist.share
- artist.shout
- Auth
- Event
- Geo
- geo.getEvents
- geo.getMetroArtistChart
- geo.getMetroTrackChart
- geo.getMetroUniqueArtistChart
- geo.getMetroUniqueTrackChart
- geo.getMetroWeeklyChartlist
- geo.getTopArtists
- geo.getTopTracks
- Group
- group.getMembers
- group.getWeeklyAlbumChart
- group.getWeeklyArtistChart
- group.getWeeklyChartList
- group.getWeeklyTrackChart
- Library
- library.addAlbum
- library.addArtist
- library.addTrack
- library.getAlbums
- library.getArtists
- library.getTracks
- Playlist
- Radio
- Tag
- tag.getSimilar
- tag.getTopAlbums
- tag.getTopArtists
- tag.getTopTags
- tag.getTopTracks
- tag.getWeeklyArtistChart
- tag.getWeeklyChartList
- tag.search
- Tasteometer
- 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.getRecentStations
- user.getRecentTracks
- user.getRecommendedArtists
- user.getRecommendedEvents
- user.getShouts
- user.getTopAlbums
- user.getTopArtists
- user.getTopTags
- user.getTopTracks
- user.getWeeklyAlbumChart
- user.getWeeklyArtistChart
- user.getWeeklyChartList
- user.getWeeklyTrackChart
- user.shout
- Venue
artist.getPastEvents
e.g. http://ws.audioscrobbler.com/2.0/?method=artist.getpastevents&artist=cher&api_key=b25b959554ed7...
Params
artist (Required) :The name of the artist you would like to fetch event listings for.page (Optional) :The page of results to return.
limit (Optional) :The maximum number of results to return per page
api_key (Required) : A Last.fm API key.
Auth
This service does not require authentication.Sample Response
<events artist="Cher" url="http://www.last.fm/music/Cher/+events" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" page="1" perPage="50" total="41" totalPages="1">
<event xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#">
<id>1196301</id>
<title>pRIvate</title>
<artists>
<artist>CSS</artist>
<artist>Madonna</artist>
<artist>Britney Spears</artist>
<artist>Lady GaGa</artist>
<artist>Cher</artist>
<artist>RuPaul</artist>
<headliner>CSS</headliner>
</artists>
<venue>
<id>9064369</id>
<name>Berlusconni´s</name>
<location>
<city>São Paulo</city>
<country>Brazil</country>
<street></street>
<postalcode></postalcode>
<geo:point>
<geo:lat>-23.5576930875657</geo:lat>
<geo:long>-46.669921875</geo:long>
</geo:point>
</location>
<url>http://www.last.fm/venue/9064369+Berlusconni%C2%B4s</url>
<website></website>
<phonenumber></phonenumber>
<image size="small"></image>
<image size="medium"></image>
<image size="large"></image>
<image size="extralarge"></image>
<image size="mega"></image>
</venue>
<startDate>Fri, 28 Aug 2009 04:42:01</startDate>
<description><![CDATA[<div class="bbcode">Rua Nestor Pestana, 189</div>]]></description>
<image size="small">http://userserve-ak.last.fm/serve/34/8834875.jpg</image>
<image size="medium">http://userserve-ak.last.fm/serve/64/8834875.jpg</image>
<image size="large">http://userserve-ak.last.fm/serve/126/8834875.jpg</image>
<image size="extralarge">http://userserve-ak.last.fm/serve/252/8834875.jpg</image>
<attendance>1</attendance>
<reviews>0</reviews>
<tag>lastfm:event=1196301</tag>
<url>http://www.last.fm/event/1196301+pRIvate</url>
<website></website>
<tickets></tickets>
<cancelled>0</cancelled>
</event>
</events>Other Formats
Also available as a feed in rss,ical formats
e.g. http://ws.audioscrobbler.com/2.0/artist/cher/pastevents.rss
e.g. http://ws.audioscrobbler.com/2.0/artist/cher/pastevents.ical
Errors
- 2 : Invalid service -This service does not exist
- 3 : Invalid Method - No method with that name in this package
- 4 : Authentication Failed - You do not have permissions to access the service
- 5 : Invalid format - This service doesn't exist in that format
- 6 : Invalid parameters - Your request is missing a required parameter
- 7 : Invalid resource specified
- 9 : Invalid session key - Please re-authenticate
- 10 : Invalid API key - You must be granted a valid key by last.fm
- 11 : Service Offline - This service is temporarily offline. Try again later.
- 12 : Subscription Error - The user needs to be subscribed in order to do that
- 13 : Invalid method signature supplied
- 18 : This user has no free radio plays left. Subscription required.