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.getImages
Get Images for this artist in a variety of sizes.
e.g. http://ws.audioscrobbler.com/2.0/?method=artist.getimages&artist=cher&api_key=b25b959554ed76058...
Params
artist (Required) : The artist name in question.page (Optiona) : Which page of limit amount to display.
limit (Optional) : How many to return. Defaults and maxes out at 50.
order (Optional) : Sort ordering can be either 'popularity' (default) or 'dateadded'. While ordering by popularity officially selected images by labels and artists will be ordered first. This is ignored and set to 'dateadded' when requested as rss.
api_key (Required) : A Last.fm API key.
Auth
This service does not require authentication.Sample Response
<images artist="Cher" page="1" totalpages="4" total="174">
<image>
<title/>
<url>http://www.last.fm/music/Cher/+images/340992</url>
<dateadded>Sun, 27 May 2007 20:21:51</dateadded>
<format>jpg</format>
<owner type="user">
<name>Fluchi</name>
<url>http://www.last.fm/user/Fluchi</url>
</owner>
<sizes>
<size name="original" width="900" height="1553">
http://userserve-ak.last.fm/serve/_/340992/Cher.jpg
</size>
<size name="large" width="126" height="217">http://....jpg</size>
<size name="largesquare" width="126" height="126">http://....jpg</size>
<size name="medium" width="64" height="110">http://....jpg</size>
<size name="small" width="34" height="59">http://....jpg</size>
</sizes>
<votes>
<thumbsup>67</thumbsup>
<thumbsdown>31</thumbsdown>
</votes>
</image>
<image>
..
</images>Other Formats
Also available as a feed in rss format
e.g. http://ws.audioscrobbler.com/2.0/artist/cher/images.rss
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.