Single movie
/movies/:rootId.xml
/movies/:tmsId.xml
Returns a single Gracenote movie entity with metadata including Root Id, TMS ID, title, description, release year, and run time. Included is a list of videos from OVD providers with metadata allowing API consumers to link to videos related to the requested movie.
Request Parameters
|
Parameter |
Mandatory? |
Description |
|
movieId |
Yes |
movie identifier; accepts either movie's root ID (numeric) or TMS ID (alphanumeric, beginning with 'MV') |
|
api_key |
Yes |
24-character key obtained during application registration |
| region | No | Two-letter region code (see Accessing International Data). To be used only with TMS ID (alphanumeric, beginning with 'SH', 'MV', 'EP') |
Sample Request 1
Request online video data using movie's rootId.
http://feeds.tmsapi.com/v2/movies/17420.xml?api_key=1234567890
Sample Request 2
Request online video data using episode's tmsId.
http://feeds.tmsapi.com/v2/movies/MV000441190000.xml?api_key=1234567890
Sample Response
<?xml version="1.0" encoding="UTF-8"?>
<ovd version="2.1">
<movie>
<rootId>17420</rootId>
<tmsId>MV000441190000</tmsId>
<title>Toy Story</title>
<description>Woody (Tom Hanks), a good-hearted cowboy doll who belongs to a young boy named Andy (John Morris), sees his position as Andy's favorite toy jeopardized when his parents buy him a Buzz Lightyear (Tim Allen) action figure. Even worse, the arrogant Buzz thinks he's a real spaceman on a mission to return to his home planet. When Andy's family moves to a new house, Woody and Buzz must escape the clutches of maladjusted neighbor Sid Phillips (Erik von Detten) and reunite with their boy.</description>
<programType>Feature Film</programType>
<year>1995</year>
<runTime>4800</runTime>
<colorCode>Color</colorCode>
<originalLanguage>en</originalLanguage>
<videos>
<video>
<id>202725826</id>
<host id="70899">iTunes Store</host>
<url>https://itunes.apple.com/us/movie/toy-story/id188703840</url>
<updatedAt>2013-01-05</updatedAt>
<viewingOptions>
<viewingOption>
<license>purchase</license>
<price currency="USD">14.99</price>
<quality>SD</quality>
</viewingOption>
<viewingOption>
<license>rental</license>
<price currency="USD">2.99</price>
<quality>SD</quality>
</viewingOption>
</viewingOptions>
</video>
<video>
<id>412219443</id>
<host id="70906">VUDU</host>
<url>http://www.vudu.com/movies/#!content/21189</url>
<image>http://images2.vudu.com/poster2/21189</image>
<updatedAt>2013-01-07</updatedAt>
<viewingOptions>
<viewingOption>
<license>purchase</license>
<price currency="USD">17.99</price>
<quality>SD</quality>
</viewingOption>
<viewingOption>
<license>rental</license>
<price currency="USD">2.00</price>
<quality>SD</quality>
</viewingOption>
</viewingOptions>
</video>
</videos>
</movie>
</ovd>