Tools
MovieRelease/Description
Returns the description of a movie release.
Syntax
| movierelease/description? | upcid=upcid moviereleaseid=moviereleaseid |
&apikey=apikey&sig=sig [&format=format] [&country=country] [&language=language] |
Request Example 1
- Request a description of a Being John Malkovich DVD using the release ID.
Request Example 2
- Request a description using the UPC code.
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. |
| moviereleaseid | Conditional | ID of a movie release. Your application can grab movie release IDs from Movie/Releases responses.
Condition: The request must contain just one of these parameters:
|
| upcid | Conditional | The numbers from the Universal Product Code (UPC) barcode that identifies an item.
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 MovieRelease/Description
| Response | Type | Description |
|---|---|---|
| author | String | Author of the description. |
| text | String | The full text of the description. |
JSON Response Example
- Here's the response to Request Example 2. 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":"025195010191"
},
"serverName":"tul1cssw3",
"startTime":"2011-04-27T17:35:24.8094961Z",
"endTime":"2011-04-27T17:35:24.8719973Z",
"duration":62,
"parentIds":{
"releaseId":"E160870",
"upcId":"025195010191"
},
"description":{
"text":"Would you pay money to journey into the mind of the star of [rovilink=\"V 154933\"]Con Air[\/rovilink], [rovilink=\"V 27323\"]THE KILLING FIELDS[\/rovilink], and [rovilink=\"V 24644\"]In The Line of Fire[\/rovilink]? Puppeteer Craig Schwartz ([rovilink=\"P 16329\"]John Cusack[\/rovilink]) is having money problems, so he takes a temporary job as a file clerk on the seventh-and-a-half floor of a large office building. One day, while rummaging behind a cabinet, he finds a small door that leads to the center of the mind of actor [rovilink=\"P 44846\"]John Malkovich[\/rovilink] (played by, you guessed it, [rovilink=\"P 44846\"]John Malkovich[\/rovilink]). Craig discovers that entering the portal allows him to become [rovilink=\"P 44846\"]John Malkovich[\/rovilink] for a brief spell, and in time he and his beautiful but aloof co-worker Maxine ([rovilink=\"P 37341\"]Catherine Keener[\/rovilink]) get the bright idea to charge admission for the privilege of spending 15 minutes inside the head of a well-known actor. Malkovich realizes that something strange is happening to him, but can do little to stop it, as strangers take over his mind for a quarter-hour at a time. Craig's wife, Lotte ([rovilink=\"P195733\"]Cameron Diaz[\/rovilink]), eventually takes a trip into Malkovich's psyche, and she soon finds herself in love with Maxine, with whom Malkovich has an affair; meanwhile, Maxine in time becomes infatuated with both Craig and Lotte, but only when they're inside Malkovich. [rovilink=\"V 180993\"]Being John Malkovich[\/rovilink] marked the feature-length debut of director [rovilink=\"P263616\"]Spike Jonze[\/rovilink], who previously made acclaimed music videos for [rovilink=\"P319049\"]Weezer[\/rovilink], the [rovilink=\"P 4794\"]Beastie Boys[\/rovilink], and [rovilink=\"P524799\"]the Breeders[\/rovilink], among others.",
"author":"Mark Deming"
}
}
"status":"ok",
"code":200,
"messages":null,
"build":"1.5.1.9",
"parameters":{
"apiKey":"apikey",
"id":"025195010191"
},
"serverName":"tul1cssw3",
"startTime":"2011-04-27T17:35:24.8094961Z",
"endTime":"2011-04-27T17:35:24.8719973Z",
"duration":62,
"parentIds":{
"releaseId":"E160870",
"upcId":"025195010191"
},
"description":{
"text":"Would you pay money to journey into the mind of the star of [rovilink=\"V 154933\"]Con Air[\/rovilink], [rovilink=\"V 27323\"]THE KILLING FIELDS[\/rovilink], and [rovilink=\"V 24644\"]In The Line of Fire[\/rovilink]? Puppeteer Craig Schwartz ([rovilink=\"P 16329\"]John Cusack[\/rovilink]) is having money problems, so he takes a temporary job as a file clerk on the seventh-and-a-half floor of a large office building. One day, while rummaging behind a cabinet, he finds a small door that leads to the center of the mind of actor [rovilink=\"P 44846\"]John Malkovich[\/rovilink] (played by, you guessed it, [rovilink=\"P 44846\"]John Malkovich[\/rovilink]). Craig discovers that entering the portal allows him to become [rovilink=\"P 44846\"]John Malkovich[\/rovilink] for a brief spell, and in time he and his beautiful but aloof co-worker Maxine ([rovilink=\"P 37341\"]Catherine Keener[\/rovilink]) get the bright idea to charge admission for the privilege of spending 15 minutes inside the head of a well-known actor. Malkovich realizes that something strange is happening to him, but can do little to stop it, as strangers take over his mind for a quarter-hour at a time. Craig's wife, Lotte ([rovilink=\"P195733\"]Cameron Diaz[\/rovilink]), eventually takes a trip into Malkovich's psyche, and she soon finds herself in love with Maxine, with whom Malkovich has an affair; meanwhile, Maxine in time becomes infatuated with both Craig and Lotte, but only when they're inside Malkovich. [rovilink=\"V 180993\"]Being John Malkovich[\/rovilink] marked the feature-length debut of director [rovilink=\"P263616\"]Spike Jonze[\/rovilink], who previously made acclaimed music videos for [rovilink=\"P319049\"]Weezer[\/rovilink], the [rovilink=\"P 4794\"]Beastie Boys[\/rovilink], and [rovilink=\"P524799\"]the Breeders[\/rovilink], among others.",
"author":"Mark Deming"
}
}
XML Response Example
- Here's an XML response to Request Example 2.
<MovieReleaseDescription 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>025195010191</id>
<format>xml</format>
</parameters>
<serverName>tul1cssw2</serverName>
<startTime>2011-04-27T17:36:22.3163894Z</startTime>
<endTime>2011-04-27T17:36:22.3320145Z</endTime>
<duration>15</duration>
<parentIds>
<releaseId>E160870</releaseId>
<upcId>025195010191</upcId>
</parentIds>
<description>
<text>Would you pay money to journey into the mind of the star of [rovilink="V 154933"]Con Air[/rovilink], [rovilink="V 27323"]THE KILLING FIELDS[/rovilink], and [rovilink="V 24644"]In The Line of Fire[/rovilink]? Puppeteer Craig Schwartz ([rovilink="P 16329"]John Cusack[/rovilink]) is having money problems, so he takes a temporary job as a file clerk on the seventh-and-a-half floor of a large office building. One day, while rummaging behind a cabinet, he finds a small door that leads to the center of the mind of actor [rovilink="P 44846"]John Malkovich[/rovilink] (played by, you guessed it, [rovilink="P 44846"]John Malkovich[/rovilink]). Craig discovers that entering the portal allows him to become [rovilink="P 44846"]John Malkovich[/rovilink] for a brief spell, and in time he and his beautiful but aloof co-worker Maxine ([rovilink="P 37341"]Catherine Keener[/rovilink]) get the bright idea to charge admission for the privilege of spending 15 minutes inside the head of a well-known actor. Malkovich realizes that something strange is happening to him, but can do little to stop it, as strangers take over his mind for a quarter-hour at a time. Craig's wife, Lotte ([rovilink="P195733"]Cameron Diaz[/rovilink]), eventually takes a trip into Malkovich's psyche, and she soon finds herself in love with Maxine, with whom Malkovich has an affair; meanwhile, Maxine in time becomes infatuated with both Craig and Lotte, but only when they're inside Malkovich. [rovilink="V 180993"]Being John Malkovich[/rovilink] marked the feature-length debut of director [rovilink="P263616"]Spike Jonze[/rovilink], who previously made acclaimed music videos for [rovilink="P319049"]Weezer[/rovilink], the [rovilink="P 4794"]Beastie Boys[/rovilink], and [rovilink="P524799"]the Breeders[/rovilink], among others.</text>
<author>Mark Deming</author>
</description>
</MovieReleaseDescription>
<status>ok</status>
<code>200</code>
<messages i:nil="true"/>
<build>1.5.1.9</build>
<parameters>
<apiKey>apikey</apiKey>
<id>025195010191</id>
<format>xml</format>
</parameters>
<serverName>tul1cssw2</serverName>
<startTime>2011-04-27T17:36:22.3163894Z</startTime>
<endTime>2011-04-27T17:36:22.3320145Z</endTime>
<duration>15</duration>
<parentIds>
<releaseId>E160870</releaseId>
<upcId>025195010191</upcId>
</parentIds>
<description>
<text>Would you pay money to journey into the mind of the star of [rovilink="V 154933"]Con Air[/rovilink], [rovilink="V 27323"]THE KILLING FIELDS[/rovilink], and [rovilink="V 24644"]In The Line of Fire[/rovilink]? Puppeteer Craig Schwartz ([rovilink="P 16329"]John Cusack[/rovilink]) is having money problems, so he takes a temporary job as a file clerk on the seventh-and-a-half floor of a large office building. One day, while rummaging behind a cabinet, he finds a small door that leads to the center of the mind of actor [rovilink="P 44846"]John Malkovich[/rovilink] (played by, you guessed it, [rovilink="P 44846"]John Malkovich[/rovilink]). Craig discovers that entering the portal allows him to become [rovilink="P 44846"]John Malkovich[/rovilink] for a brief spell, and in time he and his beautiful but aloof co-worker Maxine ([rovilink="P 37341"]Catherine Keener[/rovilink]) get the bright idea to charge admission for the privilege of spending 15 minutes inside the head of a well-known actor. Malkovich realizes that something strange is happening to him, but can do little to stop it, as strangers take over his mind for a quarter-hour at a time. Craig's wife, Lotte ([rovilink="P195733"]Cameron Diaz[/rovilink]), eventually takes a trip into Malkovich's psyche, and she soon finds herself in love with Maxine, with whom Malkovich has an affair; meanwhile, Maxine in time becomes infatuated with both Craig and Lotte, but only when they're inside Malkovich. [rovilink="V 180993"]Being John Malkovich[/rovilink] marked the feature-length debut of director [rovilink="P263616"]Spike Jonze[/rovilink], who previously made acclaimed music videos for [rovilink="P319049"]Weezer[/rovilink], the [rovilink="P 4794"]Beastie Boys[/rovilink], and [rovilink="P524799"]the Breeders[/rovilink], among others.</text>
<author>Mark Deming</author>
</description>
</MovieReleaseDescription>