Single Episode

/episodes/.xml

Returns a single Gracenote Episode entity with metadata including TMS Root Id, TMS ID, title, description, airdate, season, and episode number. Included is a list of videos from OVD providers with metadata allowing API consumers to link to videos related to the requested Episode.

Request Parameters

Sample Request 1

Request online video data using episode's rootId.

http://feeds.tmsapi.com/v2/episodes/2873496.xml?api_key=1234567890

Sample Request 2

Request online video data using episode's tmsId.

http://feeds.tmsapi.com/v2/episodes/EP005984700001.xml?api_key=1234567890

Sample Response

Code
 
    <?xml version="1.0" encoding="UTF-8"?>
    <ovd version="2.0">
    
      <episode>
        <rootId>2873496</rootId>
        <tmsId>EP005984700001</tmsId>
        <title>Pilot</title>
    
        <airDate>2003-11-02</airDate>
        <seasonNumber>1</seasonNumber>
        <episodeNumber>1</episodeNumber>
        <description>Michael Bluth's (Jason Bateman) eccentric family suffers a reversal of fortune. With Portia de Rossi, Jeffrey Tambor and David Cross.</description>
    
        <videos>
          <video>
            <id>217271153</id>
            <host id="70892">Hulu</host>
            <url>http://www.hulu.com/watch/589</url>
    
            <image>http://thumbnails.hulu.com/4/608/9662_512x288_manicured__MNbEak8kGkid2v+aMDrcXQ.jpg</image>
            <updatedAt>2012-01-06</updatedAt>
            <viewingOptions>
              <viewingOption>
                <license>subscription</license>
    
                <quality>HD</quality>
              </viewingOption>
              <viewingOption>
                <license>free</license>
                <quality>SD</quality>
    
              </viewingOption>
            </viewingOptions>
          </video>
          <!-- ... followed by more videos ... -->
        </videos>
      </episode>
    
    </ovd>