Common/music/v1.1/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:
  • Bootleg
  • Cast Recording
  • Christmas
  • Compilation
  • DJ Mix
  • Exercise
  • Field Recording
  • Highlights
  • Holiday
  • Instrumental
  • Interview
  • Karaoke
  • Live Recording
  • Offensive image,title,lyrics
  • Religious
  • Remixes
  • Soundtrack
  • Studio & Live
  • Studio Recording
  • Tribute
  • Video
genres Genre [ ] Musical genres the album 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.

guestArtists AlbumArtist [ ] Names of guest artists that appear on the album, listed alphabetically by last name.
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 9, where 0 is no rating and higher numbers indicate a higher rating.
recordingDates string [ ] Dates of recordings on the album, in YYYY-MM-DD format. Multiple dates return as a list of dates or as a single range, like this: 1982-04-14_1982-11-08.
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 and subgenres relevant to 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.1/album/credits?format=xml&apikey=apikey&albumid=MW0000043068</creditsUri>
  <images i:nil="true" />
  <imagesUri>http://api.rovicorp.com/v1.1/album/images?format=xml&apikey=apikey&albumid=MW0000043068</imagesUri>
  <moods i:nil="true" />
  <moodsUri>http://api.rovicorp.com/v1.1/album/moods?format=xml&apikey=apikey&albumid=MW0000043068</moodsUri>
  <primaryReview i:nil="true" />
  <primaryReviewUri>http://api.rovicorp.com/v1.1/album/primaryReview?format=xml&apikey=apikey&albumid=MW0000043068</primaryReviewUri>
  <releases i:nil="true" />
  <releasesUri>http://api.rovicorp.com/v1.1/album/releases?format=xml&apikey=apikey&albumid=MW0000043068</releasesUri>
  <similar i:nil="true" />
  <similarUri>http://api.rovicorp.com/v1.1/album/similar?format=xml&apikey=apikey&albumid=MW0000043068</similarUri>
  <styles i:nil="true" />
  <stylesUri>http://api.rovicorp.com/v1.1/album/styles?format=xml&apikey=apikey&albumid=MW0000043068</stylesUri>
  <themes i:nil="true" />
  <themesUri>http://api.rovicorp.com/v1.1/album/themes?format=xml&apikey=apikey&albumid=MW0000043068</themesUri>
  <tracks i:nil="true" />
  <tracksUri>http://api.rovicorp.com/v1.1/album/tracks?format=xml&apikey=apikey&albumid=MW0000043068</tracksUri>
  <recordingDates i:nil="true" />
</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.1\/album\/credits?format=json&apikey=apikey&albumid=MW0000043068",
  "images":null,
  "imagesUri":"http:\/\/api.rovicorp.com\/v1.1\/album\/images?format=json&apikey=apikey&albumid=MW0000043068",
  "moods":null,
  "moodsUri":"http:\/\/api.rovicorp.com\/v1.1\/album\/moods?format=json&apikey=apikey&albumid=MW0000043068",
  "primaryReview":null,
  "primaryReviewUri":"http:\/\/api.rovicorp.com\/v1.1\/album\/primaryReview?format=json&apikey=apikey&albumid=MW0000043068",
  "releases":null,
  "releasesUri":"http:\/\/api.rovicorp.com\/v1.1\/album\/releases?format=json&apikey=apikey&albumid=MW0000043068",
  "similar":null,
  "similarUri":"http:\/\/api.rovicorp.com\/v1.1\/album\/similar?format=json&apikey=apikey&albumid=MW0000043068",
  "styles":null,
  "stylesUri":"http:\/\/api.rovicorp.com\/v1.1\/album\/styles?format=json&apikey=apikey&albumid=MW0000043068",
  "themes":null,
  "themesUri":"http:\/\/api.rovicorp.com\/v1.1\/album\/themes?format=json&apikey=apikey&albumid=MW0000043068",
  "tracks":null,
  "tracksUri":"http:\/\/api.rovicorp.com\/v1.1\/album\/tracks?format=json&apikey=apikey&albumid=MW0000043068"
  "recordingDates":null
}
 
Personal tools