API Doc

API Methods

playlist.fetch

Fetch XSPF playlists using a lastfm playlist url.

e.g. http://ws.audioscrobbler.com/2.0/?method=playlist.fetch&playlistURL=lastfm://playlist/album/202...

Params

playlistURL (Required) : A lastfm protocol playlist url ('lastfm://playlist/...') . See 'playlists' section for more information.
api_key (Required) : A Last.fm API key.

Auth

This service does not require authentication.

Sample Response

<playlist version="1">
  <title>Cher - Believe</title>
  <annotation>Cher - Believe</annotation>
  <creator>http://www.last.fm/music/Cher/Believe</creator>
  <date>2008-06-17T11:08:56</date>
  <trackList>
    <track>
      <title>Believe</title>
      <identifier>http://www.last.fm/music/Cher/_/Believe</identifier>
      <album>Believe</album>
      <creator>Cher</creator>
      <duration>240000</duration>
      <info>http://www.last.fm/music/Cher/_/Believe</info>
      <image>
        http://cdn.last.fm/coverart/130x130/2026126-648749258.jpg
      </image>
      <extension application="http://www.last.fm">
        <artistpage>http://www.last.fm/music/Cher</artistpage>
        <albumpage>http://www.last.fm/music/Cher/Believe</albumpage>
        <trackpage>http://www.last.fm/music/Cher/_/Believe</trackpage>
      </extension>
    </track>
    ...
  </trackList>
</playlist>

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.