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.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)
rtp (Optional) : Whether the user is scrobbling or not during this radio session (helps content generation)
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>
Hover over the underlined tags and attributes to get detailed information.
Errors
- 12 : Subscribers Only - This station is only available to paid last.fm subscribers
- 8 : Operation Failed - Server Error. Please try again later.
- 18 : Trial Expired - This user has no free radio plays left. Subscription required
- 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