Multiple Episodes

/episodes.xml

Similar to retrieving a single episode, multiple ids (either Root ID or TMS ID) are passed as a request parameter, and the response is a list of Gracenote Episode entities each containing the same metadata as the response for a single Episode.

Request Parameters

Sample Request 1

Request online video data using episodes' rootIds.

http://feeds.tmsapi.com/v2/episodes.xml?episode_id=2873496,2873499&api_key=1234567890

Sample Request 2

Request online video data using episodes' tmsIds.

http://feeds.tmsapi.com/v2/episodes.xml?episode_id=EP005984700001,EP005984700005&api_key=1234567890

Sample Response

Code
 
    <?xml version="1.0" encoding="UTF-8"?>
    
    <ovd version="2.0">
      <episodes>
        <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>
        <episode>
          <rootId>2873499</rootId>
    
          <tmsId>EP005984700005</tmsId>
          <title>Top Banana</title>
          <airDate>2003-11-09</airDate>
          <seasonNumber>1</seasonNumber>
    
          <episodeNumber>2</episodeNumber>
          <description>Michael searches for paperwork to keep the family business afloat; George-Michael manages the banana stand.</description>
          <videos>
            <video>
              <id>217271154</id>
    
              <host id="70892">Hulu</host>
              <url>http://www.hulu.com/watch/1786</url>
              <image>http://thumbnails.hulu.com/4/607/9832_512x288_manicured__qnhBhKxyjEW0utuYaHRDYA.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>
      </episodes>
    </ovd>