Tools
Release/Images
Returns URLs to pictures of the album release along with associated image information. Note: Access to images is governed by your subscription level and geographical location.
IMPORTANT: Photography credits must be displayed with images.
Syntax
| release/images? | eanid=eanid upcid=upcid amgpopid=amgpopid releaseid=releaseid amgclassicalid=amgclassicalid |
&apikey=apikey&sig=sig [&format=format] [&country=country] [&language=language] |
Request Example 1
- Request images of a release of the album Thriller.
Request Example 2
- Request images in an XML response.
http://api.rovicorp.com/data/v1/release/images?apikey=apikey&sig=sig&releaseid=MR0000500873&
format=xml
format=xml
Request Parameters
Click to re-sort
| Parameter | Required | Description | ||
|---|---|---|---|---|
| apikey | Yes | Access code that authorizes your request for data from Rovi. | ||
| sig | Yes | A calculated authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three strings:
Perform the calculation at the time of each request to be sure it's within a five-minute window of the server time. If you're testing the call in a browser, use our online signature generator to perform the calculation. | ||
| amgclassicalid | Conditional | All Media Guide (AMG) ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W 180317. When using an AMG Classical ID in a request, replace any spaces in the ID with plus (+) or percent20 (%20) symbols, like this: W+++180317. AMG is a legacy database of entertainment information.
Condition: The request must contain just one of these parameters:
| ||
| amgpopid | Conditional | All Media Guide (AMG) ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R 1805889. When using an AMG Pop ID in a request, replace any spaces in the ID with plus (+) or percent20 (%20) symbols, like this: R++1805889.
Condition: The request must contain just one of these parameters:
| ||
| eanid | Conditional | The numbers from the EAN barcode that identifies the release.
Condition: The request must contain just one of these parameters:
| ||
| releaseid | Conditional | Rovi Music ID for the release, consisting of the prefix MR followed by a ten-digit number. Your application can grab release IDs from responses to the following requests:
Condition: The request must contain just one of these parameters:
| ||
| upcid | Conditional | The numbers from the barcode that identifies a music release:
Condition: The request must contain just one of these parameters:
| ||
| country | No | Country of the language of the response. The current release of the API supports only US. | ||
| format | No | Format of the returned data: json or xml. The default is JSON. | ||
| language | No | Language of the response data. This request supports only en (English). |
Response
Response Header
| Response | Type | Description |
|---|---|---|
| build | String | The software release level of the API. |
| code | Integer | HTTP status code. See the status field for the text part of the code. |
| duration | Integer | Server processing time in milliseconds. The difference between startTime and endTime. |
| endTime | String | When the server sent the response (UTC time). |
| messages | Message [ ] | Elements of a multiple HTTP response status message. |
| parameters | parameters | List of the parameters included in the request. |
| parentIds | parentIds | All of the IDs for the requested object that are recognized by the API. |
| serverName | String | Name of the server that processed the request. |
| startTime | String | When the server received the request (UTC time). |
| status | String | Text part of the HTTP status code that is shown in the code field. |
Response for Release/Images
| Response | Type | Description |
|---|---|---|
| images | images | URLs to cover images of the release specified in the request. |
JSON Response Example
- Here's the response to Request Example 1. It is formatted with extra spaces and carriage returns to make it easy to read.
{
"status":"ok",
"code":200,
"messages":null,
"build":"1.5.1.9",
"parameters":{
"apiKey":"apikey",
"id":"MR0000500873"
},
"serverName":"tul1cssw2",
"startTime":"2011-04-28T01:19:42.3873038Z",
"endTime":"2011-04-28T01:19:42.4029289Z",
"duration":15,
"parentIds":{
"albumId":"MW0000056882",
"amgPopId":"R 10089",
"releaseId":"MR0000500873",
"upcId":"074643811224"
},
"images":{
"front":[
{
"height":73,
"width":75,
"formatid":71,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
},
{
"height":167,
"width":170,
"formatid":63,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
},
{
"height":246,
"width":250,
"formatid":44,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
},
{
"height":393,
"width":400,
"formatid":64,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
},
{
"height":492,
"width":500,
"formatid":16,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
},
{
"height":1063,
"width":1080,
"formatid":62,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
}
],
"back":[ ]
}
}
"status":"ok",
"code":200,
"messages":null,
"build":"1.5.1.9",
"parameters":{
"apiKey":"apikey",
"id":"MR0000500873"
},
"serverName":"tul1cssw2",
"startTime":"2011-04-28T01:19:42.3873038Z",
"endTime":"2011-04-28T01:19:42.4029289Z",
"duration":15,
"parentIds":{
"albumId":"MW0000056882",
"amgPopId":"R 10089",
"releaseId":"MR0000500873",
"upcId":"074643811224"
},
"images":{
"front":[
{
"height":73,
"width":75,
"formatid":71,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
},
{
"height":167,
"width":170,
"formatid":63,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
},
{
"height":246,
"width":250,
"formatid":44,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
},
{
"height":393,
"width":400,
"formatid":64,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
},
{
"height":492,
"width":500,
"formatid":16,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
},
{
"height":1063,
"width":1080,
"formatid":62,
"url":"http:\/\/actual-url-concealed.jpg",
"author":null,
"copyrightOwner":null
}
],
"back":[ ]
}
}
XML Response Example
- Here's the response to Request Example 2.
<ReleaseImages xmlns="com.rovicorp.metadataservice" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<status>ok</status>
<code>200</code>
<messages i:nil="true"/>
<build>1.5.1.9</build>
<parameters>
<apiKey>apikey</apiKey>
<id>MR0000500873</id>
<format>xml</format>
</parameters>
<serverName>tul1cssw1</serverName>
<startTime>2011-04-28T01:19:54.2489987Z</startTime>
<endTime>2011-04-28T01:19:54.2489987Z</endTime>
<duration>0</duration>
<parentIds>
<albumId>MW0000056882</albumId>
<amgPopId>R 10089</amgPopId>
<releaseId>MR0000500873</releaseId>
<upcId>074643811224</upcId>
</parentIds>
<images>
<front>
<Image>
<height>73</height>
<width>75</width>
<formatid>71</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
<Image>
<height>167</height>
<width>170</width>
<formatid>63</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
<Image>
<height>246</height>
<width>250</width>
<formatid>44</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
<Image>
<height>393</height>
<width>400</width>
<formatid>64</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
<Image>
<height>492</height>
<width>500</width>
<formatid>16</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
<Image>
<height>1063</height>
<width>1080</width>
<formatid>62</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
</front>
<back/>
</images>
</ReleaseImages>
<status>ok</status>
<code>200</code>
<messages i:nil="true"/>
<build>1.5.1.9</build>
<parameters>
<apiKey>apikey</apiKey>
<id>MR0000500873</id>
<format>xml</format>
</parameters>
<serverName>tul1cssw1</serverName>
<startTime>2011-04-28T01:19:54.2489987Z</startTime>
<endTime>2011-04-28T01:19:54.2489987Z</endTime>
<duration>0</duration>
<parentIds>
<albumId>MW0000056882</albumId>
<amgPopId>R 10089</amgPopId>
<releaseId>MR0000500873</releaseId>
<upcId>074643811224</upcId>
</parentIds>
<images>
<front>
<Image>
<height>73</height>
<width>75</width>
<formatid>71</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
<Image>
<height>167</height>
<width>170</width>
<formatid>63</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
<Image>
<height>246</height>
<width>250</width>
<formatid>44</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
<Image>
<height>393</height>
<width>400</width>
<formatid>64</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
<Image>
<height>492</height>
<width>500</width>
<formatid>16</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
<Image>
<height>1063</height>
<width>1080</width>
<formatid>62</formatid>
<url>http://actual-url-concealed.jpg</url>
<author i:nil="true"/>
<copyrightOwner i:nil="true"/>
</Image>
</front>
<back/>
</images>
</ReleaseImages>