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

Parameter

Mandatory?

Description

episode_id

Yes

comma-separated list of episode identifiers; accepts either episode's root ID (numeric) or TMS ID (alphanumeric, beginning with 'EP')

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 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

<?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>