API Doc

API Methods

radio.getPlaylist

Fetch new radio content periodically in an XSPF format.

Params

discovery (Optional) : Whether to request last.fm content with discovery mode switched on.
rtp (Optional) : Whether the user is scrobbling or not during this radio session (helps content generation)
buylinks (Optional) : Whether the response should contain links for purchase/download, if available (default false)
speed_multiplier (Optional) : The rate at which to provide the stream (supported multipliers are 1.0 and 2.0)
bitrate (Optional) : What bitrate to stream content at, in kbps (supported bitrates are 64 and 128)
api_key (Required) : A Last.fm API key.
api_sig (Required) : A Last.fm method signature. See authentication for more information.
sk (Required) : A session key generated by authenticating a user via the authentication protocol.

Auth

This service requires authentication. Please see our authentication how-to.

Sample Response

<playlist version="1" xmlns="http://xspf.org/ns/0/">
 <title>+Cher+Similar+Artists</title>
 <creator>Last.fm</creator>
 <date>2007-11-26T17:34:38</date>
 <link rel="http://www.last.fm/expiry">3600</link>
 <trackList>
  <track>
   <location>http://play.last.fm/ ... .mp3</location>
   <title>Two People (Live)</title>
   <identifier>8212510</identifier>
   <album>Tina Live In Europe</album>
   <creator>Tina Turner</creator>
   <duration>265000</duration>
   <image>http:// ... .jpg</image>
   <extension application="http://www.last.fm">
     <artistpage></artistpage>
     <albumpage>...</albumpage>
     <trackpage>...</trackpage>
     <buyTrackURL>...</buyTrackURL>
     <buyAlbumURL>...</buyAlbumURL>
     <freeTrackURL>...</freeTrackURL>
   </extension>
  </track>
   ...
 </trackList>
</playlist>

Errors

18 : Trial Expired - This user has no free radio plays left. Subscription required
12 : Subscribers Only - This station is only available to paid last.fm subscribers
8 : Operation Failed - Server Error. Please try again later.
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