Single series

/series/:rootId.xml
/series/:tmsId.xml

Returns a single Gracenote Series entity with metadata including TMS Root Id, TMS ID, title, description, and airdate. Included is a list of Gracenote Episode nodes, with associated metadata and containing a list of videos from OVD providers. This endpoint provides the most high-level data of the API, a super-set of Series, Episode, and Video data.

Request Parameters

Parameter	Mandatory?	Description
seriesId	Yes	series identifier; accepts series' root ID (numeric) or TMS ID (alphanumeric, beginning with 'SH')
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 series' rootId.

http://feeds.tmsapi.com/v2/series/184931.xml?api_key=1234567890

Sample Request 2

Request online video data using series' tmsId.

http://feeds.tmsapi.com/v2/series/SH005984700000.xml?api_key=1234567890

Sample Response

<?xml version="1.0" encoding="UTF-8"?>
<ovd version="2.0">
  <series>

    <rootId>184931</rootId>
    <tmsId>SH005984700000</tmsId>
    <title>Arrested Development</title>
    <description>An eccentric family suffers a reversal of fortune.</description>

    <airDate>2003-11-02</airDate>
    <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>
      <!-- ... followed by more episodes ... -->
     </episodes>
  </series>

</ovd>

version 13 as of 1 year ago by bwait