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

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.