API Doc

API Methods

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

mbid (Optional) : The musicbrainz id for the artist
artist (Required (unless mbid)] : The artist name
page (Optiona) : The page number to fetch. Defaults to first page.
limit (Optional) : The number of results to fetch per page. Defaults to 50.
autocorrect[0|1] (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead. The corrected artist name will be returned in the response.
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
8 : Operation failed - Something else went wrong
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.
13 : Invalid method signature supplied
16 : There was a temporary error processing your request. Please try again
26 : Suspended API key - Access for your account has been suspended, please contact Last.fm
29 : Rate limit exceeded - Your IP has made too many requests in a short period