This is Inside RadioTime, a website that gives Broadcasters, Developers, OEMs and Advertisers looking for the 411 on the RadioTime guide.

getMediaMetadata

Summary

Returns detailed metadata for a specific station, show or episode.

Input

Parameter Description
id The ID of the item to retrieve

Example request:

<?xml version="1.0" encoding="utf-16"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <credentials xmlns="http://www.sonos.com/Services/1.1">
      <deviceId>0A:23:32:5B:9E:DC</deviceId>
      <deviceProvider>YourProduct</deviceProvider>
    </credentials>
  </soap:Header>
  <soap:Body>
    <getMediaMetadata xmlns="http://www.sonos.com/Services/1.1">
      <id>s32500</id>
    </getMediaMetadata>
  </soap:Body>
</soap:Envelope>

Output

A <mediaMetadata> element with detail for the item, such the show now playing on the requested station.

<?xml version="1.0" encoding="utf-16"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <getMediaMetadataResponse xmlns="http://www.sonos.com/Services/1.1">
      <getMediaMetadataResult>
        <id>s32500</id>
        <title>KERA (Dallas, TX)</title>
        <itemType>stream</itemType>
        <streamMetadata>
          <currentShowId>p61903</currentShowId>
          <currentShow>Think</currentShow>
          <currentHost>Krys Boyd</currentHost>
          <bitrate>0</bitrate>
          <logo>http://radiotime-logos.s3.amazonaws.com/s32500q.gif</logo>
          <title>90.1 FM</title>
          <subtitle>Dallas, United States</subtitle>
          <secondsRemaining>3675</secondsRemaining>
          <secondsToNextShow>3675</secondsToNextShow>
        </streamMetadata>
      </getMediaMetadataResult>
    </getMediaMetadataResponse>
  </soap:Body>
</soap:Envelope>