TvRest/V1/ProgramDetails

Jump to: navigation, search

Listings/ProgramDetails

Note: The information returned by this request is also returned by requests offered in our Video API Version 1.1. Because future API development around this information will be focused on the Video API, we now recommend using the Video API for future application development instead of this request.

Listings/ProgramDetails returns information about a series, movie, episode, or program, and can optionally include a schedule of upcoming broadcasts of the show.

To include a schedule of upcoming broadcasts, specify the serviceid of the television service. To limit and format the returned schedule, use the following optional parameters:

  • duration
  • startdate
  • sourceid
  • startindex
  • pagesize
  • inprogress

Notice: The include parameter, which is documented as optional with a default value, is temporarily required due to a bug. If you want the default value for this parameter, please specify include=Program while we correct this bug.

Syntax

listings/programdetails/[serviceid/]programid/info?apikey=apikey&sig=sig&locale=locale [&include=include] [&duration=duration] [&inprogress=inprogress] [&sourceid=sourceid] [&startdate=startdate] [&copytype=copytype] [&copytextformat=copytextformat] [&imagecount=imagecount] [&imageformat=imageformat] [&imageformatid=imageformatid] [&imagehorizontalresolution=imagehorizontalresolution] [&imagetype=imagetype] [&imageverticalresolution=imageverticalresolution] [&pagesize=pagesize] [&startindex=startindex] [&format=format]

Request Example 1

Get information about an episode of Frasier with credits and images.
http://api.rovicorp.com/TVlistings/v9/listings/programdetails/3674333/info?locale=en-US&
include=Program,Credit,Image&apikey=apikey&sig=sig

Request Example 2

Request the schedule of broadcasts of the series Frasier for Time Warner cable in Beverly Hills starting in February.
http://api.rovicorp.com/TVlistings/v9/listings/programdetails/360861/830135/info?locale=en-US&
include=Program&startdate=2011-02-01T08:00:00Z&duration=20160&apikey=apikey&sig=sig

Request Example 3

Request the schedule of broadcasts of the movie Raiders of the Lost Ark for Time Warner cable in Beverly Hills in the next week.
http://api.rovicorp.com/TVlistings/v9/listings/programdetails/360861/21243/info?locale=en-US&
include=Program&duration=10080&apikey=apikey&sig=sig

Request Example 4

Request information about an episode of Star Trek: The Next Generation with group images.
http://api.rovicorp.com/TVlistings/v9/listings/programdetails/1071438/info?locale=en-US&
include=Image&imagetype=Group&imageformatid=16&apikey=apikey&sig=sig

Request Parameters

Sort none.gif  Click to re-sort

Parameter Required Description
apikeyYesAccess code that authorizes your request for data from Rovi.
localeYesLanguage and country code of the television service. This is a case-sensitive combination of the ISO 639 language code, a hyphen character, and the ISO 3166 country code, as described in RFC 1766. Valid locales include:
  • da‑DK
Danish, Denmark
  • no‑NO
Norwegian, Norway
  • nl‑BE
Dutch, Belgium
  • pl‑PL
Polish, Poland
  • nl‑NL
Dutch, Netherlands
  • pt‑BR
Portuguese, Brazil
  • en‑BM
English (US), Bermuda
  • pt‑PT
Portuguese, Portugal
  • en‑CA
English (US), Canada
  • es‑AR
Spanish, Argentina
  • en‑IE
English (US), Ireland
  • es‑BO
Spanish, Bolivia
  • en‑JM
English (US), Jamaica
  • es‑CL
Spanish, Chile
  • en‑GB
English (UK), United Kingdom*
  • es‑CO
Spanish, Colombia
  • en‑US
English (US), United States
  • es‑CR
Spanish, Costa Rica
  • fi‑FI
Finnish, Finland
  • es‑DO
Spanish, Dominican Republic
  • fl‑BE
Flemish, Belgium
  • es‑EC
Spanish, Ecuador
  • fr‑BE
French, Belgium
  • es‑SV
Spanish, El Salvador
  • fr‑CA
French, Canada
  • es‑GT
Spanish, Guatemala
  • fr‑FR
French, France
  • es‑HN
Spanish, Honduras
  • fr‑LU
French, Luxembourg
  • es‑MX
Spanish, Mexico
  • fr‑CH
French, Switzerland
  • es‑NI
Spanish, Nicaragua
  • de‑AT
German, Austria
  • es‑PA
Spanish, Panama
  • de‑DE
German, Germany
  • es‑PE
Spanish, Peru
  • de‑LU
German, Luxembourg
  • es‑ES
Spanish, Spain
  • de‑CH
German, Switzerland
  • es‑US
Spanish, United States
  • it‑IT
Italian, Italy
  • es‑VE
Spanish, Venezuela
  • it‑CH
Italian, Switzerland
  • sv‑SE
Swedish, Sweden

* Includes Wales, Scotland, and Northern Ireland.

Note 1: Locale determines the language of program titles and descriptions. If content is not available in that language, a fallback language is chosen according to rules shown in the Language Fallback Sequence table.

Note 2: If an invalid locale is specified, en-GB will be used.

programidYesA series, episode, or program identifier. You can get program IDs from responses to the following requests:
sigYesA calculated, 32-hex-digit authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three strings:
  • Your API key.
  • The secret key you received with your API key.
  • The Unix time. Unix time is a timestamp supported in most development environments, and is generally defined as the number of seconds since January 1, 1970 00:00:00 GMT.

Express the alpha hex digits as lower case.

Perform the calculation at the time of each request to be sure it's within a five-minute window of the server time. If you're testing the call in a browser, use our online signature generator to perform the calculation.

copytextformatNoFormat of the description of the program, movie, or TV series: PlainText or HTML. Default is PlainText.
copytypeNoType of description you want returned for the program, movie, or TV series. If you specify a copy type that has no content, no description is returned.
  • 1
Chrono Long. Objective, straightforward description with up to 500 characters. Includes cast members, but not regular cast members in a series unless it is a series premiere.
  • 2
Promo. A subjective and positive description. Created for pay-per-view programs and for movies that have critical (negative) Chrono Long copy.
  • 3
NoCast. Excludes cast members. Up to 400 characters for movies, or 500 characters for a series.
  • 4
Chrono Short. A shortened version of Chrono Long with up to 254 characters and cutting positions that can be used to shorten the text.
  • 5
Grid Copy. Short plot description with up to 254 characters and cutting positions that can be used to shorten the text.
  • 54
Short Synopsis. A program description with up to 150 characters.
  • 55
Synopsis. The short synopsis plus further description up to 420 characters.
  • 10001  
AMG Movie Review. A professional movie review, which may be long, and the name of the author of the review, from All Media Guide (AMG).

If you do not specify a copy type, the description chosen is based on category, shown below, and the first copy type in the category that is available:

CategoryCopy Type Fallback Sequence
Movie

1
4
55
54
3
5

Chrono Long
Chrono Short
Synopsis
Short Synopsis
No Cast
Grid
Series Master

3
55
54

No Cast
Synopsis
Short Synopsis
Series Episode

1
55
54
4
5

Chrono Long
Synopsis
Short Synopsis
Chrono Short
Grid
One Time Only

1
55
54
4
5

Chrono Long
Synopsis
Short Synopsis
Chrono Short
Grid
Season

36
38
39

Season description (for select series and seasons)
Critical description (not currently written)
Season essay (not currently written)
durationNoIf you specify a serviceid to include a schedule of broadcasts of the show, duration determines the number of minutes the schedule will cover. You can specify 1 to 20160; the default is 20160 (14 days).

Note: The schedule is determined by duration, inprogress, and startdate. A duration shorter than 5 minutes may miss shows starting just before or after a half-hour point.

formatNoFormat of the returned data: json or xml. Default is json.
imagecountNoIf you request Image in the include parameter, imagecount determines the number of program images returned in the ProgramImages element. The default is five.

Note: Images returned meet all of the image filters specified in the request:

  • imagetype
  • imagecount
  • imageformat
  • imageformatid
  • imageverticalresolution
  • imagehorizontalresolution
imageformatNoIf you request Image in the include parameter, imageformat specifies the file format of program images returned in the ProgramImages element:
  • gif
  • jpg
  • png
  • bmp

Note: Images returned meet all of the image filters specified in the request:

  • imagetype
  • imagecount
  • imageformat
  • imageformatid
  • imageverticalresolution
  • imagehorizontalresolution
imageformatidNoIf you request Image in the include parameter, imageformatid determines the format ID of program images returned in the ProgramImages element. Format IDs specify image sizes and file types.

The image format IDs you can use are listed in the Format IDs table in the Image category. Images are not available in all format IDs, however, and images cannot be filtered by Image Format ID 0.

Note: Images returned meet all of the image filters specified in the request:

  • imagetype
  • imagecount
  • imageformat
  • imageformatid
  • imageverticalresolution
  • imagehorizontalresolution
imagehorizontalresolutionNoIf you request Image in the include parameter, imagehorizontalresolution determines the exact horizontal resolution (in pixels) of the images returned in the ProgramImages element. To return images within a particular bounding box, use the imageformatid parameter instead.

Note: Images returned meet all of the image filters specified in the request:

  • imagetype
  • imagecount
  • imageformat
  • imageformatid
  • imageverticalresolution
  • imagehorizontalresolution
imagetypeNoIf you request Image in the include parameter, imagetype determines the type of program images returned in the ProgramImages element.

The image types you can specify are shown in the ImageType table.

This parameter is case sensitive and spaces can be specified with a plus (+) or percent20 (%20) symbol, like this: imagetype=Gallery:+Key.

Note: Images returned meet all of the image filters specified in the request:

  • imagetype
  • imagecount
  • imageformat
  • imageformatid
  • imageverticalresolution
  • imagehorizontalresolution
imageverticalresolutionNoIf you request Image in the include parameter, imageverticalresolution determines the exact vertical resolution (in pixels) of the program images returned in the ProgramImages element. To return images within a particular bounding box, use the imageformatid parameter instead.

Note: Images returned meet all of the image filters specified in the request:

  • imagetype
  • imagecount
  • imageformat
  • imageformatid
  • imageverticalresolution
  • imagehorizontalresolution
includeNoData to include in the response:
  • Award
Includes any awards in the Program ProgramAwards element.
  • Credit
Includes credits in the Program ProgramCredits element.
  • Image
Includes URLs to associated images in the Program ProgramImages element.
  • Keyword
Includes descriptive keywords in the Program Keywords element.
  • Program
Returns basic information and indicates the types of metadata available in the Program DataAvailabilityFlags.
  • Seasons
Returns season information for a series in the Program ShowSeasons element. The latest season returns first.
Values are case-sensitive. To include multiple values, separate them with commas like this: include=Award,Credit,Image. Default is Program.
inprogressNoIf you specify a serviceid to include a schedule of broadcasts of the show, inprogress determines whether shows that are in progress at startdate are included in the schedule: true or false. Default is false.

Note: The schedule is determined by duration, inprogress, and startdate.

pagesizeNoIf you specify a serviceid to include a schedule of broadcasts of the show, pagesize specifies the maximum number of rows to be returned in the broadcast schedule. If fewer rows are available, the available rows are returned without error. The default is 0, which returns all rows after the startindex.

Note: You can use pagesize and startindex to paginate the returned schedule.

serviceidNoThe television service the program airs on. This must be specified if you want to return a schedule of upcoming broadcasts of the show. You can return a list of television services offered to a community with a Listings/Services request.
sourceidNoIf you specify a serviceid to include a schedule of broadcasts of the show, sourceid determines the channel or channels that will appear on the schedule. You can get the source IDs for channels from responses to Listings/ServiceDetails requests.

To specify multiple channels, specify a comma-separated list, like this: sourceid=696,873,5,994.

startdateNoIf you specify a serviceid to include a schedule of broadcasts of the show, startdate determines the starting time of the schedule. The date and time must be specified as a DateTime value. The default is the time of the request.

Note: The schedule is determined by duration, inprogress, and startdate. Broadcast information is available for 14 days after the time of the request.

startindexNoIf you specify a serviceid to include a schedule of broadcasts of the show, startindex specifies the number of the first row you want, counting from zero as the first row in the schedule. The default is zero.

Note: You can use startindex and pagesize to paginate the returned schedule.

Response

Response Header

ResponseTypeDescription
BuildStringSoftware build version of the API.
EndTimestampDateTimeTime the server finished processing the request.
ErrorsError [ ]Processing errors or warnings.
RequestIdString GUIDA generated value that identifies the request and response.
StatusStatusProcessing status, indicating whether the request was successfully processed.
TimeStampDateTimeTime the server started processing the request.

Response Body

ResponseTypeDescription
Page DataPage The number of upcoming broadcasts available, and echoes of the parameters specified for pagesize and startindex.
Program Program Information about the program.
Schedule LinearSchedule Upcoming broadcasts of the program.
UnsequencedEpisodePage DataPage The number of unsequenced episodes available.

JSON Response Example

The following shows the response for a request for information about an episode of Two and a Half Men along with a schedule of broadcasts on Time Warner Cable in Beverly Hills, California. The response has been formatted with extra spaces and carriage returns to make it easy to read.

Requested with http://api.rovicorp.com/TVlistings/v9/listings/programdetails/360861/5043606/info?
locale=en-US&include=Program&apikey=apikey&sig=sig.

{
   "ProgramDetailsResult":{
      "RequestId":"35ab4bc2-27f4-44e1-9936-e0fba3c3ba87",
      "TimeStamp":"2012-03-28T03:58:03.608Z",
      "Status":"PNE",
      "Errors":[
      ],
      "EndTimestamp":"2012-03-28T03:58:03.764Z",
      "Build":"CPS Phase v9 Build 9.8.1.10",
      "Program":{
         "DataAvailabilityFlags":"26",
         "ProgramHandle":{
            "Id":"5043606",
            "ProviderId":2
         },
         "SeriesId":"3899277",
         "TvObjectId":0,
         "MasterTitle":"Two and a Half Men",
         "EpisodeTitle":"Sleep Tight, Puddin' Pop",
         "CopyText":"Martin Sheen guest stars as Rose's dad, who confronts Charlie and asks what his intentions are towards his daughter after an inebriated Charlie sleeps with Rose on her birthday. Margaret: June Squibb. Rose: Melanie Lynskey. Evelyn: Holland Taylor. Alan: Jon Cryer.",
         "Runtime":30,
         "ProgramType":"Episode",
         "Category":"Other",
         "Subcategory":"comedy",
         "ReleaseYear":2005,
         "Season":"3",
         "EpisodeNumber":"55",
         "PartNumber":0,
         "PartTotal":0,
         "StarRating":0,
         "TVRating":"TV-14@DL",
         "MovieRating":"",
         "Subtitled":false,
         "Letterbox":false,
         "CC":true,
         "Color":"Color",
         "OriginalAirDate":"2005-11-07T00:00:00Z",
         "Syndicated":true,
         "Keywords":[

         ],
         "Credits":[

         ],
         "ProgramImages":[

         ],
         "IsVideoAvailable":null,
         "SeasonSequence":7,
         "SeriesSequence":55,
         "LastAirDate":null,
         "CuttingPositions":[
            "160",
            "177",
            "200",
            "223",
            "247"
         ],
         "ParentalRatings":[
            {
               "RatingType":"US TV",
               "Rating":"TV-14@DL",
               "Reasons":"",
               "CountryCode":"US"
            },
            {
               "RatingType":"FCTV",
               "Rating":"G",
               "Reasons":"",
               "CountryCode":"CA"
            },
            {
               "RatingType":"Germany TV",
               "Rating":"FSK: 3",
               "Reasons":"",
               "CountryCode":"DE"
            },
            {
               "RatingType":"Netherlands TV",
               "Rating":"6",
               "Reasons":"",
               "CountryCode":"NL"
            },
            {
               "RatingType":"Austria TV",
               "Rating":"None",
               "Reasons":"",
               "CountryCode":"AT"
            },
            {
               "RatingType":"Belgium TV",
               "Rating":"None",
               "Reasons":"",
               "CountryCode":"BE"
            }
         ],
         "ProgramVariants":"",
         "ProgramVideoClips":"",
         "ProgramAwards":[

         ],
         "ProgramLanguage":"English",
         "CopyTextLanguage":"English",
         "ShowSeasons":[

         ],
         "SubtitleLanguage":"",
         "SecondaryTitle":"",
         "UnsequencedEpisodes":"",
         "Streamable":1
      },
      "Schedule":{
         "Locale":"en-US",
         "ServiceId":360861,
         "Name":"Beverly Hills - Time Warner Cable- Walnut/Diamond Bar",
         "ServiceType":"Cable",
         "StartDate":"2012-03-28T03:58:03.6085258Z",
         "Duration":20160,
         "TimeZones":[
            {
               "StartDateTime":"2012-03-11T10:00:00Z",
               "EndDateTime":"2012-11-04T09:00:00Z",
               "Offset":-420
            }
         ],
         "Airings":[
            {
               "ProgramId":"4066705",
               "SeriesId":"3899277",
               "InstanceId":null,
               "UnknownInstance":false,
               "UPId":"MarMiller",
               "Title":"Two and a Half Men",
               "EpisodeTitle":"Round One to the Hot Crazy Chick",
               "Copy":"A woman stays at the house until she can solve some family problems, and both Charlie and Alan become interested in her.",
               "AiringTime":"2012-04-07T14:30:00Z",
               "Duration":30,
               "Color":"Color",
               "AiringType":"Unknown",
               "ShowingType":"Unknown",
               "CC":true,
               "LetterBox":false,
               "Stereo":true,
               "HD":false,
               "SAP":false,
               "TVRating":"TV-14@DL",
               "Dolby":false,
               "DSS":false,
               "HDLevel":"HD Level Unknown",
               "Sports":false,
               "DVS":false,
               "Category":"Other",
               "Subcategory":"comedy",
               "SourceId":398,
               "Channel":"54",
               "CallLetters":"FX",
               "SourceDisplayName":"FX-E",
               "SourceLongName":"FX (East)",
               "TiVoSupported":true,
               "ParentNetworkId":113,
               "IconAvailable":true,
               "ServiceId":360861,
               "SL": "false",
               "Subtitles": "false"
            },
            {
               "ProgramId":"4020505",
               "SeriesId":"3899277",
               "InstanceId":null,
               "UnknownInstance":false,
               "UPId":"MarMiller",
               "Title":"Two and a Half Men",
               "EpisodeTitle":"Sarah Like Puny Alan",
               "Copy":"Charlie wants Alan to go on a double date with him and two sisters, but first he has nurse an ailing Alan back to health. Johanna Black.",
               "AiringTime":"2012-04-05T05:00:00Z",
               "Duration":30,
               "Color":"Color",
               "AiringType":"Unknown",
               "ShowingType":"Unknown",
               "CC":true,
               "LetterBox":false,
               "Stereo":true,
               "HD":false,
               "SAP":false,
               "TVRating":"TV-14@DL",
               "Dolby":false,
               "DSS":false,
               "HDLevel":"HD Level Unknown",
               "Sports":false,
               "DVS":false,
               "Category":"Other",
               "Subcategory":"comedy",
               "SourceId":398,
               "Channel":"54",
               "CallLetters":"FX",
               "SourceDisplayName":"FX-E",
               "SourceLongName":"FX (East)",
               "TiVoSupported":true,
               "ParentNetworkId":113,
               "IconAvailable":true,
               "ServiceId":360861,
               "SL": "false",
               "Subtitles": "false"
            }
         ]
      },
      "Page":{
         "PageSize":2,
         "StartIndex":0,
         "TotalRows":80
      },
      "UnsequencedEpisodePage":{
         "PageSize":"0",
         "StartIndex":"0",
         "TotalRows":"0"
      }
   }
}

XML Response Example

The following shows the response for a request for information about an episode of Two and a Half Men along with a schedule of broadcasts on Time Warner Cable in Beverly Hills, California.

Requested with http://api.rovicorp.com/TVlistings/v9/listings/programdetails/360861/5043606/info?
locale=en-US&include=Program&format=xml&apikey=apikey&sig=sig.

<GetProgramDetailsResponse xmlns="http://services.macrovision.com/v9/listings">
   <GetProgramDetailsResult>
      <RequestId xmlns="http://services.macrovision.com/v9/common/types">29dd264b-005e-4779-84bf-ae528a53a017</RequestId>
      <TimeStamp xmlns="http://services.macrovision.com/v9/common/types">2012-03-28T04:02:01.186Z</TimeStamp>
      <Status xmlns="http://services.macrovision.com/v9/common/types">PNE</Status>
      <Errors xmlns="http://services.macrovision.com/v9/common/types"/>
      <EndTimestamp xmlns="http://services.macrovision.com/v9/common/types">2012-03-28T04:02:01.795Z</EndTimestamp>
      <Build xmlns="http://services.macrovision.com/v9/common/types">CPS Phase v9 Build 9.9.3.1</Build>
      <Program DataAvailabilityFlags="26">
         <ProgramHandle>
            <Id>5043606</Id>
            <ProviderId>2</ProviderId>
         </ProgramHandle>
         <SeriesId>3899277</SeriesId>
         <TvObjectId>0</TvObjectId>
         <MasterTitle>Two and a Half Men</MasterTitle>
         <EpisodeTitle>Sleep Tight, Puddin' Pop</EpisodeTitle>
         <CopyText>Martin Sheen guest stars as Rose's dad, who confronts Charlie and asks what his intentions are towards his daughter after an inebriated Charlie sleeps with Rose on her birthday. Margaret: June Squibb. Rose: Melanie Lynskey. Evelyn: Holland Taylor. Alan: Jon Cryer.</CopyText>
         <Runtime>30</Runtime>
         <ProgramType>Episode</ProgramType>
         <Category>Other</Category>
         <Subcategory>comedy</Subcategory>
         <ReleaseYear>2005</ReleaseYear>
         <Season>3</Season>
         <EpisodeNumber>55</EpisodeNumber>
         <PartNumber>0</PartNumber>
         <PartTotal>0</PartTotal>
         <StarRating>0</StarRating>
         <TVRating>TV-14@DL</TVRating>
         <MovieRating/>
         <Subtitled>false</Subtitled>
         <Letterbox>false</Letterbox>
         <CC>true</CC>
         <Color>Color</Color>
         <OriginalAirDate>2005-11-07T00:00:00Z</OriginalAirDate>
         <Syndicated>true</Syndicated>
         <Keywords/>
         <Credits/>
         <ProgramImages/>
         <IsVideoAvailable xsi:nil="true"/>
         <SeasonSequence>7</SeasonSequence>
         <SeriesSequence>55</SeriesSequence>
         <LastAirDate xsi:nil="true"/>
         <CuttingPositions>
            <int>160</int>
            <int>177</int>
            <int>200</int>
            <int>223</int>
            <int>247</int>
         </CuttingPositions>
         <ParentalRatings>
            <ParentalRating>
               <RatingType>US TV</RatingType>
               <Rating>TV-14@DL</Rating>
               <Reasons/>
               <CountryCode>US</CountryCode>
            </ParentalRating>
            <ParentalRating>
               <RatingType>FCTV</RatingType>
               <Rating>G</Rating>
               <Reasons/>
               <CountryCode>CA</CountryCode>
            </ParentalRating>
            <ParentalRating>
               <RatingType>Germany TV</RatingType>
               <Rating>FSK: 3</Rating>
               <Reasons/>
               <CountryCode>DE</CountryCode>
            </ParentalRating>
            <ParentalRating>
               <RatingType>Netherlands TV</RatingType>
               <Rating>6</Rating>
               <Reasons/>
               <CountryCode>NL</CountryCode>
            </ParentalRating>
            <ParentalRating>
               <RatingType>Austria TV</RatingType>
               <Rating>None</Rating>
               <Reasons/>
               <CountryCode>AT</CountryCode>
            </ParentalRating>
            <ParentalRating>
               <RatingType>Belgium TV</RatingType>
               <Rating>None</Rating>
               <Reasons/>
               <CountryCode>BE</CountryCode>
            </ParentalRating>
         </ParentalRatings>
         <ProgramVariants/>
         <ProgramVideoClips/>
         <ProgramAwards/>
         <ProgramLanguage>English</ProgramLanguage>
         <CopyTextLanguage>English</CopyTextLanguage>
         <ShowSeasons/>
         <SubtitleLanguage/>
         <SecondaryTitle/>
         <UnsequencedEpisodes/>
         <Streamable>1</Streamable>
      </Program>
      <Schedule>
         <Locale>en-US</Locale>
         <ServiceId>360861</ServiceId>
         <Name>Beverly Hills - Time Warner Cable- Walnut/Diamond Bar</Name>
         <ServiceType>Cable</ServiceType>
         <StartDate>2012-03-27T07:00:00Z</StartDate>
         <Duration>20160</Duration>
         <TimeZones>
            <TimeZoneInfo>
               <StartDateTime>2012-03-11T10:00:00Z</StartDateTime>
               <EndDateTime>2012-11-04T09:00:00Z</EndDateTime>
               <Offset>-420</Offset>
            </TimeZoneInfo>
         </TimeZones>
         <Airings>
            <ListingsAiring>
               <ProgramId>4066705</ProgramId>
               <SeriesId>3899277</SeriesId>
               <InstanceId xsi:nil="true"/>
               <UnknownInstance>false</UnknownInstance>
               <UPId>MarMiller</UPId>
               <Title>Two and a Half Men</Title>
               <EpisodeTitle>Round One to the Hot Crazy Chick</EpisodeTitle>
               <Copy>Charlie invites a mysterious woman to stay at the house until she can settle family problems. Jenna Elfman.</Copy>
               <AiringTime>2012-04-07T14:30:00Z</AiringTime>
               <Duration>30</Duration>
               <Color>Color</Color>
               <AiringType>Unknown</AiringType>
               <ShowingType>Unknown</ShowingType>
               <CC>true</CC>
               <LetterBox>false</LetterBox>
               <Stereo>true</Stereo>
               <HD>false</HD>
               <SAP>false</SAP>
               <TVRating>TV-14@DL</TVRating>
               <Dolby>false</Dolby>
               <DSS>false</DSS>
               <HDLevel>HD Level Unknown</HDLevel>
               <Sports>false</Sports>
               <DVS>false</DVS>
               <Category>Other</Category>
               <Subcategory>comedy</Subcategory>
               <SourceId>398</SourceId>
               <Channel>54</Channel>
               <CallLetters>FX</CallLetters>
               <SourceDisplayName>FX-E</SourceDisplayName>
               <SourceLongName>FX (East)</SourceLongName>
               <TiVoSupported>true</TiVoSupported>
               <ParentNetworkId>113</ParentNetworkId>
               <IconAvailable>true</IconAvailable>
               <ServiceId>360861</ServiceId>
               <SL>false</SL>
               <Subtitles>false</Subtitles>
            </ListingsAiring>
            <ListingsAiring>
               <ProgramId>4020505</ProgramId>
               <SeriesId>3899277</SeriesId>
               <InstanceId xsi:nil="true"/>
               <UnknownInstance>false</UnknownInstance>
               <UPId>MarMiller</UPId>
               <Title>Two and a Half Men</Title>
               <EpisodeTitle>Sarah Like Puny Alan</EpisodeTitle>
               <Copy>Charlie wants Alan to go on a double date with him and two sisters, but first he has nurse an ailing Alan back to health. Johanna Black.</Copy>
               <AiringTime>2012-04-05T05:00:00Z</AiringTime>
               <Duration>30</Duration>
               <Color>Color</Color>
               <AiringType>Unknown</AiringType>
               <ShowingType>Unknown</ShowingType>
               <CC>true</CC>
               <LetterBox>false</LetterBox>
               <Stereo>true</Stereo>
               <HD>false</HD>
               <SAP>false</SAP>
               <TVRating>TV-14@DL</TVRating>
               <Dolby>false</Dolby>
               <DSS>false</DSS>
               <HDLevel>HD Level Unknown</HDLevel>
               <Sports>false</Sports>
               <DVS>false</DVS>
               <Category>Other</Category>
               <Subcategory>comedy</Subcategory>
               <SourceId>398</SourceId>
               <Channel>54</Channel>
               <CallLetters>FX</CallLetters>
               <SourceDisplayName>FX-E</SourceDisplayName>
               <SourceLongName>FX (East)</SourceLongName>
               <TiVoSupported>true</TiVoSupported>
               <ParentNetworkId>113</ParentNetworkId>
               <IconAvailable>true</IconAvailable>
               <ServiceId>360861</ServiceId>
               <SL>false</SL>
               <Subtitles>false</Subtitles>
            </ListingsAiring>
         </Airings>
      </Schedule>
      <Page>
         <PageSize>2</PageSize>
         <StartIndex>0</StartIndex>
         <TotalRows>79</TotalRows>
      </Page>
      <UnsequencedEpisodePage>
         <PageSize>0</PageSize>
         <StartIndex>0</StartIndex>
         <TotalRows>0</TotalRows>
      </UnsequencedEpisodePage>
   </GetProgramDetailsResult>
</GetProgramDetailsResponse>

Error Codes

CodeNameDescription
1001 Core_MandatoryFieldMissing A mandatory parameter is not specified.
5001 Core_InvalidPagingStartIndex The startindex parameter is negative, non-numeric, or results in a negative range.
5002 Core_InvalidPagingPageSize The pagesize specified is negative or non-numeric.
502001 Listings_InvalidCopyType The copytype specified in the request is invalid.
502002 NoPrimaryProgramVariantExists Warning: No primary program variant exists. Normally the data from the primary program ID is returned, however this program has no primary program ID.

A program may have multiple IDs, each of which is categorized as primary or variant. Variants differ in some way from the primary, such as title, format, content, language, or cast (for animated shows).

See Also

↑ Top

 
Retrieved from "http://prod-doc.rovicorp.com/mashery/index.php/TvRest/V1/ProgramDetails"
Personal tools