Web Services


Fetch new radio content periodically in an XSPF format.

Example URLs

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


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.


This service does not require authentication.

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