• Register

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>