Web Services


Fetch new radio content periodically in an XSPF format.


discovery (Optional) : Whether to request 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 API key.
api_sig (Required) : A method signature. See authentication for more information.
sk (Required) : A session key generated by authenticating a user via the authentication protocol.


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

Sample Response

<playlist version="1" xmlns="">
 <link rel="">3600</link>
   <location> ... .mp3</location>
   <title>Two People (Live)</title>
   <album>Tina Live In Europe</album>
   <creator>Tina Turner</creator>
   <image>http:// ... .jpg</image>
   <extension application="">
Hover over the underlined tags and attributes to get detailed information.


  • 12 : Subscribers Only - This station is only available to paid 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
  • 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
  • 29 : Rate limit exceeded - Your IP has made too many requests in a short period