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>