Last.fm Web Services

radio.tune

Tune in to a Last.fm radio station.

Params

lang (Optional) : An ISO language code to determine the language to return the station name in, expressed as an ISO 639 alpha-2 code.
station (Required) : A lastfm:// radio URL
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.
This is a write service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See rest requests for more information.

Sample Response

<lfm status="ok">
	<station>
		<type>artist</type>
		<name>Cher Similar Artists</name>
		<url>http://www.last.fm/listen/artist/Cher/similarartists</url>
		<supportsdiscovery>1</supportsdiscovery>
	</station>
</lfm>

Errors

  • 20 : Not Enough Content - There is not enough content to play this station
  • 21 : Not Enough Members - This group does not have enough members for radio
  • 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
  • 22 : Not Enough Fans - This artist does not have enough fans for for radio
  • 23 : Not Enough Neighbours - There are not enough neighbours for radio
  • 28 : Geo Restricted - This station is not available with this client/country combination
  • 27 : Deprecated - This station is no longer available
  • 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