V1.Metadata.Common:NameCredit

Jump to: navigation, search

NameCredit

Contains information about a movie or television credit.

Elements

NameTypeDescription
category ProgramCategory Category of television program: news, movie, sports, etc.
creditType CreditType Type of credit.
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 String Date the program first aired, in M/D/YYYY order.
ids ids All of the IDs for the movie or program that are, or will be, recognized by the Video Service:
  • iguideId
  • cosmoId
  • amgMovieId
image image A primary image for the program based on criteria shown in the Image Order table.

Note: Images returned with credits are JPG files with images that fit a bounding box of 80 pixels wide by 60 pixels high in one or both dimensions.

lastAirDate String Date the program last aired, in M/D/YYYY order.
numberOfEpisodes Integer For a series, the number of episodes the person appeared in.
partName String Role in the movie, series, episode, or program in less than 256 characters.
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 a television series.
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.
videoUri String A customized Video/Info request, returned only if a trailer associated with this credit is available.

XML Response Example

<NameCredit>
  <ids>
    <movieId i:nil="true"/>
    <cosmoId>3899298</cosmoId>
  </ids>
  <seriesId i:nil="true"/>
  <title>NCIS</title>
  <episodeTitle i:nil="true"/>
  <programType>Series</programType>
  <category>Other</category>
  <releaseYear>2003</releaseYear>
  <partName>Leroy Jethro Gibbs</partName>
  <creditType>Actor</creditType>
  <startYear i:nil="true"/>
  <endYear i:nil="true"/>
  <image>
    <height>60</height>
    <width>47</width>
    <formatid>38</formatid>
    <url>http://actual-url-concealed.jpg</url>
    <author>CBS</author>
    <copyrightOwner i:nil="true"/>
  </image>
  <starRating i:nil="true"/>
  <programLanguage>English</programLanguage>
  <firstAirDate>9/23/2003</firstAirDate>
  <lastAirDate i:nil="true"/>
  <numberOfEpisodesIn>210</numberOfEpisodesIn>
  <videoUri>http://api.rovicorp.com/v1/video/info?format=xml&amp;apikey=4p1k3y&amp;cosmoid=3899298</videoUri>
</NameCredit>

JSON Response Example

{
   "ids":{
      "movieId":null,
      "cosmoId":"3899298"
   },
   "seriesId":null,
   "title":"NCIS",
   "episodeTitle":null,
   "programType":"Series",
   "category":"Other",
   "releaseYear":"2003",
   "partName":"Leroy Jethro Gibbs",
   "creditType":"Actor",
   "startYear":null,
   "endYear":null,
   "image":{
      "height":60,
      "width":47,
      "formatid":38,
      "url":"http:\/\/actual-url-concealed.jpg",
      "author":"CBS",
      "copyrightOwner":null
   },
   "starRating":null,
   "programLanguage":"English",
   "firstAirDate":"9\/23\/2003",
   "lastAirDate":null,
   "numberOfEpisodesIn":210,
   "videoUri":"http:\/\/api.rovicorp.com\/v1\/video\/info?format=json&apikey=4p1k3y&cosmoid=3899298"
}
 
Retrieved from "http://prod-doc.rovicorp.com/mashery/index.php/V1.Metadata.Common:NameCredit"
Personal tools