Last.fm Web Services

radio.tune

Tune in to a Last.fm radio station.

Example URLs

To get an example URL for this API call you'll first need to join Last.fm and then get an API account.

Params

station (Required) : A lastfm:// radio URL
lang (Optional) : An ISO language code to determine the language to return the station name in, expressed as an ISO 639 alpha-2 code.
api_key (Required) : A Last.fm API key.

Auth

This service does not require authentication.

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