V1.Metadata.Common:Album2

Jump to: navigation, search

Album

Contains information about an album.

Elements

NameTypeDescription
classicalReview classicalReview An editorial review of a classical music album, returned only if the request specified an include=classicalreview argument.
classicalReviewUri String The customized Album/ClassicalReview request, returned only if the data is available.
credits AlbumCredit [ ] Production credits for the album, returned only if the request specified an include=credits argument.
creditsUri String The customized Album/Credits request, returned only if the data is available.
duration Integer Playing time in seconds.
flags String [ ] Additional features and characteristics that apply to the album:
  • 24-Bit Mastered
  • Arrangement
  • Bootleg
  • Cast Recording
  • Christmas
  • Collectors Edition
  • Compilation
  • Digitally Remastered
  • DJ Mix
  • Exercise
  • Expurgated Version
  • Gold
  • HDCD Mastered
  • Highlights
  • Holiday
  • Instrumental
  • International Version
  • Interview
  • Karaoke
  • Limited Edition
  • Offensive image,title,lyrics
  • Religious
  • Remixes
  • Slow
  • Soundtrack
  • Tribute
  • Video
  • XRCD Mastered
genres Genre [ ] Musical genres the album falls into, along with a weighting that reflects the relative importance of each genre.
guestArtists AlbumArtist [ ] Names of guest artists that appear on the album.
headlineReview headlineReview A capsule review that sums up the critical and historical perspective of the album in one or two sentences.
ids ids All of the IDs that are recognized by the API for an album. The possible IDs are:
  • albumId
  • amgPopId
  • amgClassicalId
images Image [ ] URLs to images of the front and back album covers, returned only if the request specified an include=images argument and your subscription level enables access to images. Note: Photography credits must be displayed with images.
imagesUri String The customized Album/Images request, returned only if the data is available.
isPick Boolean Whether the album is recommended by Rovi: true or false.
moods Mood [ ] Terms that describe expressive characteristics of the music, returned only if the request specified an include=moods argument.
moodsUri String The customized Album/Moods request, returned only if the data is available.
originalReleaseDate String Date of the first release of the album in YYYY-MM-DD format.
primaryArtists AlbumArtist [ ] Names of the primary artists on the album.
primaryReview primaryReview The most recent major review of the album, returned only if the request specified an include=primaryreview argument.
primaryReviewUri String The customized Album/PrimaryReview request, returned only if the data is available.
rating Integer An editorially assigned rating of the album from 0 to 10, where 0 is no rating and higher numbers indicate a higher rating.
releases AlbumRelease [ ] List of the album releases, returned only if the request specified an include=releases argument.
releasesUri String The customized Album/Releases request, returned only if the data is available.
similar AlbumSimilar [ ] Similar albums to the album named in the request, returned only if the request specified an include=similar argument.

Notice: This property is deprecated and will be removed from the API on a date to be announced.

similarUri String The customized Album/Similar request, returned only if the data is available.

Notice: This property is deprecated and will be removed from the API on a date to be announced.

styles Style [ ] Musical styles relevant to the music on the album, returned only if the request specified an include=styles argument.
stylesUri String The customized Album/Styles request, returned only if the data is available.
themes Theme [ ] Topics, feelings, and circumstances that motivate or fit with the music, returned only if the request specified an include=themes argument.
themesUri String The customized Album/Themes request, returned only if the data is available.
title String Full name of the album.
tracks Track [ ] List of tracks on the album, returned only if the request specified an include=tracks argument.
tracksUri String The customized Album/Tracks request, returned only if the data is available.

XML Response Example

<Album>
  <ids>
    <albumId>MW0000043068</albumId>
    <amgClassicalId i:nil="true" />
    <amgPopId>R 381778</amgPopId>
  </ids>
  <title>Double Live</title>
  <primaryArtists>
    <AlbumArtist>
      <id>MN0000798248</id>
      <name>Garth Brooks</name>
    </AlbumArtist>
  </primaryArtists>
  <guestArtists>
    <AlbumArtist>
    <id>MN0000032333</id>
    <name>Susan Ashton</name>
    </AlbumArtist>
    <AlbumArtist>
      <id>MN0000804642</id>
      <name>Ty England</name>
    </AlbumArtist>
    <AlbumArtist>
      <id>MN0000151290</id>
      <name>Béla Fleck</name>
    </AlbumArtist>
    <AlbumArtist>
      <id>MN0000044751</id>
      <name>Steve Wariner</name>
    </AlbumArtist>
    <AlbumArtist>
      <id>MN0000749476</id>
      <name>Trisha Yearwood</name>
    </AlbumArtist>
  </guestArtists>
  <flags i:nil="true" xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
  <duration>6047</duration>
  <originalReleaseDate>1998-11-17</originalReleaseDate>
  <rating>4</rating>
  <isPick>false</isPick>
  <genres>
    <Genre>
      <id>MA0000002532</id>
      <name>Country</name>
      <weight>10</weight>
    </Genre>
  </genres>
  <headlineReview i:nil="true" />
  <classicalReview i:nil="true" />
  <classicalReviewUri i:nil="true" />
  <credits i:nil="true" />
  <creditsUri>http://api.rovicorp.com/v1/album/credits?format=xml&apikey=apikey&albumid=MW0000043068</creditsUri>
  <images i:nil="true" />
  <imagesUri>http://api.rovicorp.com/v1/album/images?format=xml&apikey=apikey&albumid=MW0000043068</imagesUri>
  <moods i:nil="true" />
  <moodsUri>http://api.rovicorp.com/v1/album/moods?format=xml&apikey=apikey&albumid=MW0000043068</moodsUri>
  <primaryReview i:nil="true" />
  <primaryReviewUri>http://api.rovicorp.com/v1/album/primaryReview?format=xml&apikey=apikey&albumid=MW0000043068</primaryReviewUri>
  <releases i:nil="true" />
  <releasesUri>http://api.rovicorp.com/v1/album/releases?format=xml&apikey=apikey&albumid=MW0000043068</releasesUri>
  <similar i:nil="true" />
  <similarUri>http://api.rovicorp.com/v1/album/similar?format=xml&apikey=apikey&albumid=MW0000043068</similarUri>
  <styles i:nil="true" />
  <stylesUri>http://api.rovicorp.com/v1/album/styles?format=xml&apikey=apikey&albumid=MW0000043068</stylesUri>
  <themes i:nil="true" />
  <themesUri>http://api.rovicorp.com/v1/album/themes?format=xml&apikey=apikey&albumid=MW0000043068</themesUri>
  <tracks i:nil="true" />
  <tracksUri>http://api.rovicorp.com/v1/album/tracks?format=xml&apikey=apikey&albumid=MW0000043068</tracksUri>
</Album>

JSON Response Example

The following example has been formatted with extra spaces and carriage returns to make it easy to read.
{
  "ids":{
    "albumId":"MW0000043068",
    "amgClassicalId":null,
    "amgPopId":"R  381778"
  },
  "title":"Double Live",
  "primaryArtists":[
    {
      "id":"MN0000798248",
      "name":"Garth Brooks"
    }
  ],
  "guestArtists":[
    {
      "id":"MN0000032333",
      "name":"Susan Ashton"
    },
    {
      "id":"MN0000804642",
      "name":"Ty England"
    },
    {
      "id":"MN0000151290",
      "name":"Béla Fleck"
    },
    {
      "id":"MN0000044751",
      "name":"Steve Wariner"
    },
    {
      "id":"MN0000749476",
      "name":"Trisha Yearwood"
    }
  ],
  "flags":null,
  "duration":6047,
  "originalReleaseDate":"1998-11-17",
  "rating":4,
  "isPick":false,
  "genres":[
    {
      "id":"MA0000002532",
      "name":"Country",
      "weight":10
    }
  ],
  "headlineReview":null,
  "classicalReview":null,
  "classicalReviewUri":null,
  "credits":null,
  "creditsUri":"http:\/\/api.rovicorp.com\/v1\/album\/credits?format=json&apikey=apikey&albumid=MW0000043068",
  "images":null,
  "imagesUri":"http:\/\/api.rovicorp.com\/v1\/album\/images?format=json&apikey=apikey&albumid=MW0000043068",
  "moods":null,
  "moodsUri":"http:\/\/api.rovicorp.com\/v1\/album\/moods?format=json&apikey=apikey&albumid=MW0000043068",
  "primaryReview":null,
  "primaryReviewUri":"http:\/\/api.rovicorp.com\/v1\/album\/primaryReview?format=json&apikey=apikey&albumid=MW0000043068",
  "releases":null,
  "releasesUri":"http:\/\/api.rovicorp.com\/v1\/album\/releases?format=json&apikey=apikey&albumid=MW0000043068",
  "similar":null,
  "similarUri":"http:\/\/api.rovicorp.com\/v1\/album\/similar?format=json&apikey=apikey&albumid=MW0000043068",
  "styles":null,
  "stylesUri":"http:\/\/api.rovicorp.com\/v1\/album\/styles?format=json&apikey=apikey&albumid=MW0000043068",
  "themes":null,
  "themesUri":"http:\/\/api.rovicorp.com\/v1\/album\/themes?format=json&apikey=apikey&albumid=MW0000043068",
  "tracks":null,
  "tracksUri":"http:\/\/api.rovicorp.com\/v1\/album\/tracks?format=json&apikey=apikey&albumid=MW0000043068"
}
 
Personal tools