V9.Common:CelebrityCredit

Jump to: navigation, search

CelebrityCredit

Contains information about a credit that a person has earned on a movie, series, episode, or program.

Elements

NameTypeDescription
Category ProgramCategory Category of television program: news, movie, sports, etc.
CopyText String Description of the series, movie, or program in less than 2000 characters. Several types of descriptions (copy types) are available, and the copy type you specify in the request is the first one chosen. If the description for that copy type is empty, or 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.

Descriptions may be formatted as text (the default) or as HTML, according to the format specified by the request.

The copy types shown below in each category define a fallback sequence. If a description is not found in one copy type, the next copy type in the list is chosen. If no description is found, nothing is returned.

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)

CopyTextSource CopyTextSource Source of the program description returned in the CopyText element. This property is not returned if no data is available.
CreditHandle Handle Database identifier for the person.
CreditName String Name of the person, as shown in the credit, in less than 256 characters.
CreditType CreditType Type of credit.
DataAvailabilityFlags Integer Sum of the bit mask values that indicate what data is available about the movie, series, episode, or program. For example: if Summary and Credits are available, then DataAvailbilityFlags will equal HasSummary + HasCredits (2 + 16) or 18.
HasReview
HasSummary
HasImages
HasAwards
16 HasCredits
32 HasVideo
64 HasSimilar
128 HasTVSeason
256 HasTVEpisodes
EndYear Integer For a TV series, the year the person stopped working on the series. May be null.
EpisodeTitle String Title of the episode, returned only for episodes in a series. Limited to fewer than 32 characters.
FirstAirDate DateTime Date the program first aired. May be null.
Image Image A primary image for the program based on criteria shown in the Image Order table.

Note: Images returned with credits are image format ID 36: JPG files with images that fit a bounding box of 140 pixels by 140 pixels in one or both dimensions.

LastAirDate DateTime Date the program last aired. May be null.
NumberOfEpisodes Integer For a series, the number of episodes the person appeared in.
ParentalRatings ParentalRating [ ] Parental ratings assigned to the program.
PartName String Role in the movie, series, episode, or program in less than 256 characters.
ProgramHandle Handle Database identifier of the movie, series, episode, or program.
ProgramLanguage String Language of the movie or program.
ProgramType ProgramType Type of program: movie, episode, etc.
ReleaseYear Integer Year the program was released.
SeriesId String Database ID of the series, returned for an episode in a series if your request included credits for episodes.
StarRating Integer Rovi editorial rating of the program. May be null.
StartYear Integer For a TV series, the year the person started work on the series. May be null.
Title String Title of the program or, if the program is an episode in a series, the title of the series. Limited to fewer than 256 characters.

XML Response Example

<CelebrityCredit DataAvailabilityFlags="127">
   <CreditHandle>
      <Id>100911</Id>
      <ProviderId>2</ProviderId>
   </CreditHandle>
   <ProgramHandle>
      <Id>5671249</Id>
      <ProviderId>2</ProviderId>
   </ProgramHandle>
   <Title>X-Men: The Last Stand</Title>
   <ProgramType>Movie</ProgramType>
   <Category>Movie</Category>
   <ReleaseYear>2006</ReleaseYear>
   <CreditName>Patrick Stewart</CreditName>
   <PartName>Professor Charles Xavier</PartName>
   <CreditType>Actor</CreditType>
   <StartYear xsi:nil="true"/>
   <EndYear xsi:nil="true"/>
   <CopyText>Sequel about the mutant superheroes facing the possibility of becoming normal. Halle Berry, Hugh Jackman. A.k.a. “X-Men 3.”</CopyText>
   <Image>
      <ImageUrl>http://actual-url-concealed.jpg</ImageUrl>
      <ImageUseType xsi:nil="true"/>
      <ImageId>4785243</ImageId>
      <ImageTitle>X-Men: The Last Stand</ImageTitle>
      <ImageCaption>Poster art</ImageCaption>
      <ObjectId>5671249</ObjectId>
      <ObjectType>Program</ObjectType>
      <ObjectName>X-Men: The Last Stand</ObjectName>
      <Relevancy>true</Relevancy>
      <ImageCredit>20th Century Fox</ImageCredit>
      <ImageCreditDisplay xsi:nil="true"/>
      <ImageCastWeight>1</ImageCastWeight>
      <ImageZoomLevel>4</ImageZoomLevel>
      <ImageHeadcount>5</ImageHeadcount>
      <ImageType>Poster Art</ImageType>
      <ImageFormat>jpg</ImageFormat>
      <ImageHorizontalResolution>99</ImageHorizontalResolution>
      <ImageVerticalResolution>140</ImageVerticalResolution>
      <ImageMaintainAspectFlag xsi:nil="true"/>
      <ImageExpiryDateTime xsi:nil="true"/>
      <LastUpdate>2011-10-14T15:44:14.137Z</LastUpdate>
      <ImageFormatId>36</ImageFormatId>
      <Orientation>Portrait</Orientation>
      <AspectRatio>7:10</AspectRatio>
      <ImageOwner>20th Century Fox</ImageOwner>
      <ParentImageId>16787185</ParentImageId>
      <MaxImageScale>6.44</MaxImageScale>
   </Image>
   <StarRating>2</StarRating>
   <ParentalRatings>
      <ParentalRating>
         <RatingType>MPAA</RatingType>
         <Rating>PG-13</Rating>
         <Reasons>
            <string>SS</string>
            <string>SL</string>
            <string>V</string>
         </Reasons>
      </ParentalRating>
      <ParentalRating>
         <RatingType>US TV</RatingType>
         <Rating>None</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>OFRB</RatingType>
         <Rating>PG</Rating>
         <Reasons>
            <string>V</string>
         </Reasons>
      </ParentalRating>
      <ParentalRating>
         <RatingType>RCQ</RatingType>
         <Rating>G</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>FCTV</RatingType>
         <Rating>None</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>Belgium TV</RatingType>
         <Rating>Tous</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>France TV</RatingType>
         <Rating>Tous</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>Netherlands TV</RatingType>
         <Rating>12</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>Spain TV</RatingType>
         <Rating>12</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>Sweden TV</RatingType>
         <Rating>11</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>United Kingdom TV</RatingType>
         <Rating>12</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>Austria TV</RatingType>
         <Rating>None</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>Norway TV</RatingType>
         <Rating>None</Rating>
         <Reasons/>
      </ParentalRating>
      <ParentalRating>
         <RatingType>Italy TV</RatingType>
         <Rating>T</Rating>
         <Reasons/>
      </ParentalRating>
   </ParentalRatings>
   <ProgramLanguage>English</ProgramLanguage>
   <FirstAirDate xsi:nil="true"/>
   <LastAirDate xsi:nil="true"/>
   <NumberOfEpisodes>0</NumberOfEpisodes>
</CelebrityCredit>

JSON Response Example

JSON responses are available from our REST TV Listings service.
{
   "DataAvailabilityFlags":"127",
   "CreditHandle":{
      "Id":"100911",
      "ProviderId":"2"
   },
   "ProgramHandle":{
      "Id":"5671249",
      "ProviderId":"2"
   },
   "Title":"X-Men: The Last Stand",
   "ProgramType":"Movie",
   "Category":"Movie",
   "ReleaseYear":"2006",
   "CreditName":"Patrick Stewart",
   "PartName":"Professor Charles Xavier",
   "CreditType":"Actor",
   "StartYear":null,
   "EndYear":null,
   "CopyText":"Sequel about the mutant superheroes facing the possibility of becoming normal. Halle Berry, Hugh Jackman. A.k.a. \u201cX-Men 3.\u201d",
   "Image":{
      "ImageUrl":"http:\/\/actual-url-concealed.jpg",
      "ImageUseType":null,
      "ImageId":"4785243",
      "ImageTitle":"X-Men: The Last Stand",
      "ImageCaption":"Poster art",
      "ObjectId":"5671249",
      "ObjectType":"Program",
      "ObjectName":"X-Men: The Last Stand",
      "Relevancy":"true",
      "ImageCredit":"20th Century Fox",
      "ImageCreditDisplay":null,
      "ImageCastWeight":"1",
      "ImageZoomLevel":"4",
      "ImageHeadcount":"5",
      "ImageType":"Poster Art",
      "ImageFormat":"jpg",
      "ImageHorizontalResolution":"99",
      "ImageVerticalResolution":"140",
      "ImageMaintainAspectFlag":null,
      "ImageExpiryDateTime":null,
      "LastUpdate":"2011-10-14T15:44:14.137Z",
      "ImageFormatId":"36",
      "Orientation":"Portrait",
      "AspectRatio":"7:10",
      "ImageOwner":"20th Century Fox",
      "ParentImageId":"16787185",
     "MaxImageScale":"6.44"
   },
   "StarRating":"2",
   "ParentalRatings":{
      "ParentalRating":[
         {
            "RatingType":"MPAA",
            "Rating":"PG-13",
            "Reasons":{
               "string":"SSSLV"
            }
         },
         {
            "RatingType":"US TV",
            "Rating":"None",
            "Reasons":""
         },
         {
            "RatingType":"OFRB",
            "Rating":"PG",
            "Reasons":{
               "string":"V"
            }
         },
         {
            "RatingType":"RCQ",
            "Rating":"G",
            "Reasons":""
         },
         {
            "RatingType":"FCTV",
            "Rating":"None",
            "Reasons":""
         },
         {
            "RatingType":"Belgium TV",
            "Rating":"Tous",
            "Reasons":""
         },
         {
            "RatingType":"France TV",
            "Rating":"Tous",
            "Reasons":""
         },
         {
            "RatingType":"Netherlands TV",
            "Rating":"12",
            "Reasons":""
         },
         {
            "RatingType":"Spain TV",
            "Rating":"12",
            "Reasons":""
         },
         {
            "RatingType":"Sweden TV",
            "Rating":"11",
            "Reasons":""
         },
         {
            "RatingType":"United Kingdom TV",
            "Rating":"12",
            "Reasons":""
         },
         {
            "RatingType":"Austria TV",
            "Rating":"None",
            "Reasons":""
         },
         {
            "RatingType":"Norway TV",
            "Rating":"None",
            "Reasons":""
         },
         {
            "RatingType":"Italy TV",
            "Rating":"T",
            "Reasons":""
         },
         {
            "RatingType":"Belgacom Ratings",
            "Rating":"All",
            "Reasons":""
         }
      ]
   },
   "ProgramLanguage":"English",
   "FirstAirDate":null,
   "LastAirDate":null,
   "NumberOfEpisodes":"0"
}
 
Personal tools