Tools
Movie/Releases
Returns information about DVDs, Blu-rays, and other movie releases.
This request may return a large amount of data. To speed data transmission, do the following:
- Request one page of data at a time, requesting only what you want to immediately display.
- Request a compressed response by including Accept-Encoding: gzip,deflate in the HTTP header.
Syntax
| movie/releases? | movie=movie movieid=movieid cosmoid=cosmoid |
&apikey=apikey&sig=sig [&format=format] [&offset=offset] [&count=count] [&country=country] [&language=language] |
Request Example 1
- Request the releases of Being John Malkovich using the movie ID.
Request Example 2
- Request the releases using the movie title.
Request Example 3
- Request just the first release in the list.
Request Example 4
- Request just the second release.
http://api.rovicorp.com/data/v1/movie/releases?apikey=apikey&sig=sig&movieid=V+++180993&offset=1& count=1
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. |
| cosmoid | Conditional | Cosmo database ID for a movie or television series. Cosmo is a database of television information.
Condition: The request must contain just one of these parameters:
|
| movie | Conditional | Keywords from the title of the movie or TV series. This searches for the most popular title with that combination of words. Replace spaces with plus (+) or percent20 (%20) symbols.
Condition: The request must contain just one of these parameters:
|
| movieid | Conditional | AMG ID of a movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. When using an AMG Video ID in a request, replace any spaces in the ID with plus (+) or percent20 (%20) symbols, like this: V+++295550. Your application can grab movie IDs from responses to the following requests:
Condition: The request must contain just one of these parameters:
|
| count | No | Number of items to be returned. The default is zero, which returns all items after the offset.
Use count and offset to paginate the response. |
| 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). |
| offset | No | Number of items at the start of the returned list to skip. The default is zero.
Use count and offset to paginate the response. |
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. |
| view | view | Summary of items returned in a list of items. |
Response for Movie/Releases
| Response | Type | Description |
|---|---|---|
| releases | MovieRelease [ ] | Information about DVDs, Blu-rays, and other releases of the movie 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":"V 180993"
},
"view":{
"total":4
},
"serverName":"tul1cssw1",
"startTime":"2011-04-27T01:23:59.7474282Z",
"endTime":"2011-04-27T01:23:59.7474282Z",
"duration":0,
"parentIds":{
"cosmoId":"2512627",
"movieId":"V 180993"
},
"releases":[
{
"ids":{
"releaseId":"E105134",
"upcId":null
},
"title":"Being John Malkovich",
"studio":"Columbia Tristar",
"rating":9,
"formats":[
"DVD"
],
"year":"2000 09 18",
"hasCommentary":true,
"isPurchasable":true
},
{
"ids":{
"releaseId":"E116967",
"upcId":null
},
"title":"Being John Malkovich",
"studio":"Universal",
"rating":9,
"formats":[
"DVD"
],
"year":"2003 08 11",
"hasCommentary":true,
"isPurchasable":true
},
{
"ids":{
"releaseId":"E 7888",
"upcId":null
},
"title":"Being John Malkovich",
"studio":"Polygram USA Video",
"rating":9,
"formats":[
"DVD"
],
"year":"2000 05 02",
"hasCommentary":true,
"isPurchasable":true
},
{
"ids":{
"releaseId":"E160870",
"upcId":null
},
"title":"Being John Malkovich [HD]",
"studio":"Universal Studios",
"rating":9,
"formats":[
"Hi Def"
],
"year":"2007 06 26",
"hasCommentary":true,
"isPurchasable":true
}
]
}
"status":"ok",
"code":200,
"messages":null,
"build":"1.5.1.9",
"parameters":{
"apiKey":"apikey",
"id":"V 180993"
},
"view":{
"total":4
},
"serverName":"tul1cssw1",
"startTime":"2011-04-27T01:23:59.7474282Z",
"endTime":"2011-04-27T01:23:59.7474282Z",
"duration":0,
"parentIds":{
"cosmoId":"2512627",
"movieId":"V 180993"
},
"releases":[
{
"ids":{
"releaseId":"E105134",
"upcId":null
},
"title":"Being John Malkovich",
"studio":"Columbia Tristar",
"rating":9,
"formats":[
"DVD"
],
"year":"2000 09 18",
"hasCommentary":true,
"isPurchasable":true
},
{
"ids":{
"releaseId":"E116967",
"upcId":null
},
"title":"Being John Malkovich",
"studio":"Universal",
"rating":9,
"formats":[
"DVD"
],
"year":"2003 08 11",
"hasCommentary":true,
"isPurchasable":true
},
{
"ids":{
"releaseId":"E 7888",
"upcId":null
},
"title":"Being John Malkovich",
"studio":"Polygram USA Video",
"rating":9,
"formats":[
"DVD"
],
"year":"2000 05 02",
"hasCommentary":true,
"isPurchasable":true
},
{
"ids":{
"releaseId":"E160870",
"upcId":null
},
"title":"Being John Malkovich [HD]",
"studio":"Universal Studios",
"rating":9,
"formats":[
"Hi Def"
],
"year":"2007 06 26",
"hasCommentary":true,
"isPurchasable":true
}
]
}
XML Response Example
- Here's an XML response to Request Example 1.
<MovieReleases 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>V 180993</id>
<format>xml</format>
</parameters>
<view>
<total>4</total>
</view>
<serverName>tul1cssw3</serverName>
<startTime>2011-04-27T01:24:15.4743531Z</startTime>
<endTime>2011-04-27T01:24:15.4899784Z</endTime>
<duration>15</duration>
<parentIds>
<cosmoId>2512627</cosmoId>
<movieId>V 180993</movieId>
</parentIds>
<releases>
<MovieRelease>
<ids>
<releaseId>E105134</releaseId>
<upcId i:nil="true"/>
</ids>
<title>Being John Malkovich</title>
<studio>Columbia Tristar</studio>
<rating>9</rating>
<formats xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>DVD</a:string>
</formats>
<year>2000 09 18</year>
<hasCommentary>true</hasCommentary>
<isPurchasable>true</isPurchasable>
</MovieRelease>
<MovieRelease>
<ids>
<releaseId>E116967</releaseId>
<upcId i:nil="true"/>
</ids>
<title>Being John Malkovich</title>
<studio>Universal</studio>
<rating>9</rating>
<formats xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>DVD</a:string>
</formats>
<year>2003 08 11</year>
<hasCommentary>true</hasCommentary>
<isPurchasable>true</isPurchasable>
</MovieRelease>
<MovieRelease>
<ids>
<releaseId>E 7888</releaseId>
<upcId i:nil="true"/>
</ids>
<title>Being John Malkovich</title>
<studio>Polygram USA Video</studio>
<rating>9</rating>
<formats xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>DVD</a:string>
</formats>
<year>2000 05 02</year>
<hasCommentary>true</hasCommentary>
<isPurchasable>true</isPurchasable>
</MovieRelease>
<MovieRelease>
<ids>
<releaseId>E160870</releaseId>
<upcId i:nil="true"/>
</ids>
<title>Being John Malkovich [HD]</title>
<studio>Universal Studios</studio>
<rating>9</rating>
<formats xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>Hi Def</a:string>
</formats>
<year>2007 06 26</year>
<hasCommentary>true</hasCommentary>
<isPurchasable>true</isPurchasable>
</MovieRelease>
</releases>
</MovieReleases>
<status>ok</status>
<code>200</code>
<messages i:nil="true"/>
<build>1.5.1.9</build>
<parameters>
<apiKey>apikey</apiKey>
<id>V 180993</id>
<format>xml</format>
</parameters>
<view>
<total>4</total>
</view>
<serverName>tul1cssw3</serverName>
<startTime>2011-04-27T01:24:15.4743531Z</startTime>
<endTime>2011-04-27T01:24:15.4899784Z</endTime>
<duration>15</duration>
<parentIds>
<cosmoId>2512627</cosmoId>
<movieId>V 180993</movieId>
</parentIds>
<releases>
<MovieRelease>
<ids>
<releaseId>E105134</releaseId>
<upcId i:nil="true"/>
</ids>
<title>Being John Malkovich</title>
<studio>Columbia Tristar</studio>
<rating>9</rating>
<formats xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>DVD</a:string>
</formats>
<year>2000 09 18</year>
<hasCommentary>true</hasCommentary>
<isPurchasable>true</isPurchasable>
</MovieRelease>
<MovieRelease>
<ids>
<releaseId>E116967</releaseId>
<upcId i:nil="true"/>
</ids>
<title>Being John Malkovich</title>
<studio>Universal</studio>
<rating>9</rating>
<formats xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>DVD</a:string>
</formats>
<year>2003 08 11</year>
<hasCommentary>true</hasCommentary>
<isPurchasable>true</isPurchasable>
</MovieRelease>
<MovieRelease>
<ids>
<releaseId>E 7888</releaseId>
<upcId i:nil="true"/>
</ids>
<title>Being John Malkovich</title>
<studio>Polygram USA Video</studio>
<rating>9</rating>
<formats xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>DVD</a:string>
</formats>
<year>2000 05 02</year>
<hasCommentary>true</hasCommentary>
<isPurchasable>true</isPurchasable>
</MovieRelease>
<MovieRelease>
<ids>
<releaseId>E160870</releaseId>
<upcId i:nil="true"/>
</ids>
<title>Being John Malkovich [HD]</title>
<studio>Universal Studios</studio>
<rating>9</rating>
<formats xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>Hi Def</a:string>
</formats>
<year>2007 06 26</year>
<hasCommentary>true</hasCommentary>
<isPurchasable>true</isPurchasable>
</MovieRelease>
</releases>
</MovieReleases>