V1.Metadata.Common:Song

Jump to: navigation, search

Song

Contains information about a song.

Elements

NameTypeDescription
appearances SongAppearance [ ] Albums and videos the song appears on, returned only if the request specified an include=appearances argument.
appearancesUri String The customized Song/Appearances request, returned only if the data is available.
genres Genre [ ] Musical genres the song falls into, along with a weighting that reflects the relative importance of each genre.
ids ids All of the IDs that are recognized by the API for a song. The possible IDs are:
  • isrcId
  • muzeId
  • trackId
  • amgPopTrackId
  • amgClassicalTrackId
isPick Boolean Whether the song is recommended by Rovi: true or false.
moods Mood [ ] Support for this response is ending soon.
moodsUri String Support for this response is ending soon.
primaryArtists AlbumArtist [ ] Names of the primary artists on the song.
review Review The most recent review of the song, returned only if the request specified an include=review argument.
reviewUri String The customized Song/Review request, returned only if the data is available.
sample String URL to an audio sample, returned only if requested by an include argument. Song samples are 30-second MP3 clips encoded in stereo at 96 kbit/s. File size is approximately 357 kB.

Note: Access to music samples through the API is governed by your subscription level.

sampleUri String The customized Song/Sample request, returned only if a sample is available.
styles Style [ ] Support for this response is ending soon.
stylesUri String Support for this response is ending soon.
themes Theme [ ] Support for this response is ending soon.
themesUri String Support for this response is ending soon.
title String Title of the song.

XML Response Example

<Song>
  <ids>
    <amgClassicalTrackId i:nil="true" />
    <amgPopTrackId>T 16139376</amgPopTrackId>
    <isrcId>USUM70807646</isrcId>
    <muzeId>17151455</muzeId>
    <trackId>MT0009995109</trackId>
  </ids>
  <title>Just Dance</title>
  <primaryArtists>
    <AlbumArtist>
      <id>MN0000994823</id>
      <name>Lady Gaga</name>
    </AlbumArtist>
    <AlbumArtist>
      <id>MN0000106145</id>
      <name>Colby O'Donis</name>
    </AlbumArtist>
  </primaryArtists>
  <isPick>true</isPick>
  <genres>
    <Genre>
      <id>MA0000002613</id>
      <name>Pop/Rock</name>
      <weight>7</weight>
    </Genre>
    <Genre>
      <id>MA0000002809</id>
      <name>R&B</name>
      <weight>7</weight>
    </Genre>
  </genres>
  <appearances i:nil="true" />
  <appearancesUri>http://api.rovicorp.com/v1/song/appearances?format=xml&apikey=apikey&trackId=MT0009995109</appearancesUri>
  <moods i:nil="true" />
  <moodsUri>http://api.rovicorp.com/v1/song/moods?format=xml&apikey=apikey&trackId=MT0009995109</moodsUri>
  <review i:nil="true" />
  <reviewUri i:nil="true" />
  <styles i:nil="true" />
  <stylesUri>http://api.rovicorp.com/v1/song/styles?format=xml&apikey=apikey&trackId=MT0009995109</stylesUri>
  <themes i:nil="true" />
  <themesUri>http://api.rovicorp.com/v1/song/themes?format=xml&apikey=apikey&trackId=MT0009995109</themesUri>
  <sample i:nil="true" />
  <sampleUri>http://api.rovicorp.com/v1/song/sample?format=xml&apikey=apikey&trackId=MT0009995109</sampleUri>
  </Song>
<Song>

JSON Response Example

{
  "ids":{
   "amgClassicalTrackId":null,
   "amgPopTrackId":"T 16139376",
   "isrcId":"USUM70807646",
   "muzeId":"17151455",
   "trackId":"MT0009995109"
  },
  "title":"Just Dance",
  "primaryArtists":[
   {
    "id":"MN0000994823",
    "name":"Lady Gaga"
   },
   {
    "id":"MN0000106145",
    "name":"Colby O'Donis"
   }
  ],
  "isPick":true,
  "genres":[
   {
    "id":"MA0000002613",
    "name":"Pop\/Rock",
    "weight":7
   },
   {
    "id":"MA0000002809",
    "name":"R&B",
    "weight":7
   }
  ],
  "appearances":null,
  "appearancesUri":"http:\/\/api.rovicorp.com\/v1\/song\/appearances?format=json&apikey=apikey&trackId=MT0009995109",
  "moods":null,
  "moodsUri":"http:\/\/api.rovicorp.com\/v1\/song\/moods?format=json&apikey=apikey&trackId=MT0009995109",
  "review":null,
  "reviewUri":null,
  "styles":null,
  "stylesUri":"http:\/\/api.rovicorp.com\/v1\/song\/styles?format=json&apikey=apikey&trackId=MT0009995109",
  "themes":null,
  "themesUri":"http:\/\/api.rovicorp.com\/v1\/song\/themes?format=json&apikey=apikey&trackId=MT0009995109",
  "sample":null,
  "sampleUri":"http:\/\/api.rovicorp.com\/v1\/song\/sample?format=json&apikey=apikey&trackId=MT0009995109"
}
 
Retrieved from "http://prod-doc.rovicorp.com/mashery/index.php/V1.Metadata.Common:Song"
Personal tools