Common/music/v1.1/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.
attributes SongAttribute An audio analysis of the song, a response soon to be available to customers at an advanced subscription level.
attributesUri string A customized request for an audio analysis of the song, a response soon to be available to customers at an advanced subscription level.
genres Genre [ ] Musical genres the song falls into, along with a weighting that reflects the relative importance of each genre.

Genres are sorted in order of importance (highest to lowest weight) and, within the same weight, alphabetically by genre name.

ids ids All of the IDs that are recognized by the API for a song. The possible IDs are:
  • isrcId
  • trackId
  • muzeId
  • 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, listed alphabetically by last name.
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>
  <attributes i:nil="true"/>
  <attributesUri i:nil="true"/>
  <appearances i:nil="true" />
  <appearancesUri>http://api.rovicorp.com/v1.1/song/appearances?format=xml&apikey=apikey&trackId=MT0009995109</appearancesUri>
  <moods i:nil="true" />
  <moodsUri>http://api.rovicorp.com/v1.1/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.1/song/styles?format=xml&apikey=apikey&trackId=MT0009995109</stylesUri>
  <themes i:nil="true" />
  <themesUri>http://api.rovicorp.com/v1.1/song/themes?format=xml&apikey=apikey&trackId=MT0009995109</themesUri>
  <sample i:nil="true" />
  <sampleUri>http://api.rovicorp.com/v1.1/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
   }
  ],
  "attributes":null,
  "attributesUri":null,
  "appearances":null,
  "appearancesUri":"http:\/\/api.rovicorp.com\/v1.1\/song\/appearances?format=json&apikey=apikey&trackId=MT0009995109",
  "moods":null,
  "moodsUri":"http:\/\/api.rovicorp.com\/v1.1\/song\/moods?format=json&apikey=apikey&trackId=MT0009995109",
  "review":null,
  "reviewUri":null,
  "styles":null,
  "stylesUri":"http:\/\/api.rovicorp.com\/v1.1\/song\/styles?format=json&apikey=apikey&trackId=MT0009995109",
  "themes":null,
  "themesUri":"http:\/\/api.rovicorp.com\/v1.1\/song\/themes?format=json&apikey=apikey&trackId=MT0009995109",
  "sample":null,
  "sampleUri":"http:\/\/api.rovicorp.com\/v1.1\/song\/sample?format=json&apikey=apikey&trackId=MT0009995109"
}
 
 
 
Retrieved from "http://prod-doc.rovicorp.com/mashery/index.php/Common/music/v1.1/Song"
Personal tools