Sonos Music API - Reference

getExtendedMetadataText

Sonos uses the getExtendedMetadataText request to get more information about an item. This call is designed to be a follow-up to a getExtendedMetadata call.

Request Parameters

Name

Type

Description

Id

String(128)

The unique ID of the item that Sonos is requesting extended metadata. This can be a track, album, artist, or other item type.

Type

string(32)

Enum type of text to get. This is the same enum text returned in the <relatedText> node of the getExtendedMetadata call for the SMAPI ID. 

Response

Name

Type

Description

getExtendedMetadataTextResult 

string

The actual body of the text.

Sample Request

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getExtendedMetadataText xmlns="http://www.sonos.com/Services/1.1">
      <id>T:123456789</id>
      <type>ARTIST_BIO</type>
    </getExtendedMetadataText>
   </soap:Body>
</soap:Envelope>

Sample Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getExtendedMetadataTextResponse xmlns="http://www.sonos.com/Services/1.1">
      <getExtendedMetadataTextResult>
        [Body of text goes here.]
      </getExtendedMetadataTextResult>
    </getExtendedMetadataTextResponse>
  </soap:Body>
</soap:Envelope>