V9.ListingsService:GetCelebrityDetailsExamples

Jump to: navigation, search

GetCelebrityDetails Request Examples

Here are some examples that show how you can use GetCelebrityDetails.

« GetCelebrityDetails

Request Example 1

Request a personal and professional overview for Ice-T.

  • Specify en-US in the Locale element.
  • In the CreditHandle element, specify the ID for Ice-T and specify 2 in the ProviderId element.
  • In the Metadata element, specify the data to be returned:
    • AKAs
    • Relations
    • Biography
    • Factsheets

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:typ="http://api.rovicorp.com/v9/common/types" xmlns:lis="http://api.rovicorp.com/v9/listings">
   <soapenv:Header>
      <typ:AuthHeader>
         <typ:UserName>username</typ:UserName>
         <typ:Password>password</typ:Password>
      </typ:AuthHeader>
   </soapenv:Header>
   <soapenv:Body>
      <lis:GetCelebrityDetails>
         <lis:request>
            <lis:Locale>en-US</lis:Locale>
            <lis:CreditHandle>
               <lis:Id>101086</lis:Id>
               <lis:ProviderId>2</lis:ProviderId>
            </lis:CreditHandle>
            <lis:MetaData>
               <lis:CelebrityMetaData>Biography</lis:CelebrityMetaData>
               <lis:CelebrityMetaData>Factsheets</lis:CelebrityMetaData>
               <lis:CelebrityMetaData>AKAs</lis:CelebrityMetaData>
               <lis:CelebrityMetaData>Relations</lis:CelebrityMetaData>
            </lis:MetaData>
            <lis:Format xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:ServiceId xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:StartDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:Duration xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:InProgress xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:TitleType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:CopyType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:IncludeCreditsForEpisodes xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:ImageCount xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
         </lis:request>
      </lis:GetCelebrityDetails>
   </soapenv:Body>
</soapenv:Envelope>

Here's the response to this request.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <GetCelebrityDetailsResponse xmlns="http://api.rovicorp.com/v9/listings">
         <GetCelebrityDetailsResult>
            <RequestId xmlns="http://api.rovicorp.com/v9/common/types">8fe1357d-ba0f-4606-b041-711a05558ac6</RequestId>
            <TimeStamp xmlns="http://api.rovicorp.com/v9/common/types">2011-06-10T19:20:44.576Z</TimeStamp>
            <Status xmlns="http://api.rovicorp.com/v9/common/types">PNE</Status>
            <Errors xmlns="http://api.rovicorp.com/v9/common/types"/>
            <EndTimestamp xmlns="http://api.rovicorp.com/v9/common/types">2011-06-10T19:20:44.607Z</EndTimestamp>
            <Build xmlns="http://api.rovicorp.com/v9/common/types">CPS Phase v9 Build 9.5.1.8</Build>
            <Celebrity DataAvailabilityFlags="12">
               <CreditHandle>
                  <Id>101086</Id>
                  <ProviderId>2</ProviderId>
               </CreditHandle>
               <CreditName>Ice-T</CreditName>
               <FirstName/>
               <LastName>Ice-T</LastName>
               <BirthName>Tracy Marrow</BirthName>
               <BirthPlace>Newark, NJ</BirthPlace>
               <DateOfBirth>02/16/1958</DateOfBirth>
               <DateOfDeath>00/00/0000</DateOfDeath>
               <Gender>M</Gender>
               <Zodiac>Aquarius</Zodiac>
               <Profession>Actor; musician</Profession>
               <HighSchool>Crenshaw High School, Los Angeles, CA</HighSchool>
               <College/>
               <Description>Rapper; Actor</Description>
               <Factsheets>
                  <Factsheet LanguageId="1">
                     <Type>Factsheet</Type>
                     <Details><![CDATA[<UL>
<LI>Got his big break in the 1984&nbsp;break-dancing film, <I>Breakin'</I>.
<LI>Stage name was inspired by author Iceberg Slim (the pen name of Robert Maupin Beck III). Ice-T wrote the introduction to the author's posthumously released novel <I>Doom Fox</I>.
<LI>Rapped as a guest artist on the Black Sabbath album <I>Forbidden</I> in 1995.
<LI>Provided the voices for video-game characters in <I>Sanity: Aiken's Artifact</I> and <I>Grand Theft Auto: San Andreas</I>.
<LI>Joined the cast of <I>Law &amp; Order: Special Victims Unit</I> in the second season, after a four episode guest arc turned in a regular position.
<LI>Launched a clothing line, IceWear, in 2005. </LI></UL>]]></Details>
                  </Factsheet>
                  <Factsheet LanguageId="1">
                     <Type>FactSheetOnline</Type>
                     <Details><![CDATA[<UL>
<LI>Got his big break in the 1984&nbsp;break-dancing film, <I>Breakin'</I>.
<LI>Stage name was inspired by author Iceberg Slim (the pen name of Robert Maupin Beck III). Ice-T wrote the introduction to the author's posthumously released novel <I>Doom Fox</I>.
<LI>Rapped as a guest artist on the Black Sabbath album <I>Forbidden</I> in 1995.
<LI>Provided the voices for video-game characters in <I>Sanity: Aiken's Artifact</I> and <I>Grand Theft Auto: San Andreas</I>.
<LI>Joined the cast of <I>Law &amp; Order: Special Victims Unit</I> in the second season, after a four episode guest arc turned in a regular position.
<LI>Launched a clothing line, IceWear, in 2005. </LI></UL>]]></Details>
                  </Factsheet>
               </Factsheets>
               <Awards/>
               <AKAs>
                  <AKA>
                     <FirstName xmlns="http://api.rovicorp.com/v9/common/types"/>
                     <LastName xmlns="http://api.rovicorp.com/v9/common/types">Ice T</LastName>
                  </AKA>
                  <AKA>
                     <FirstName xmlns="http://api.rovicorp.com/v9/common/types">Tracy</FirstName>
                     <LastName xmlns="http://api.rovicorp.com/v9/common/types">Marrow</LastName>
                  </AKA>
               </AKAs>
               <Relatives>
                  <Relative>
                     <Name>Coco</Name>
                     <Relationship>Wife</Relationship>
                     <RelativeCreditId>633830</RelativeCreditId>
                  </Relative>
               </Relatives>
               <Credits/>
               <Images/>
               <IsCelebrity>true</IsCelebrity>
            </Celebrity>
         </GetCelebrityDetailsResult>
      </GetCelebrityDetailsResponse>
   </soap:Body>
</soap:Envelope>

Request Example 2

Request a schedule for the shows that Ice-T is appearing in over the next week on Time Warner Cable in Beverly Hills, California.
  • Specify en-US in the Locale element.
  • Specify 360861 in the ServiceId element.
  • Specify 10080 in the Duration element, setting the number of minutes of schedule information to be returned.
  • In the CreditHandle element, specify the ID for Ice-T and specify 2 in the ProviderId element.
  • In the Metadata element, specify None to return just the schedule that is specified by the ServiceId and Duration. (You can specify other options instead to also return other data.)
  • Specify true in the InProgress element to catch any shows that are currently on.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:typ="http://api.rovicorp.com/v9/common/types" xmlns:lis="http://api.rovicorp.com/v9/listings">
   <soapenv:Header>
      <typ:AuthHeader>
         <typ:UserName>username</typ:UserName>
         <typ:Password>password</typ:Password>
      </typ:AuthHeader>
   </soapenv:Header>
   <soapenv:Body>
      <lis:GetCelebrityDetails>
         <lis:request>
            <lis:Locale>en-US</lis:Locale>
            <lis:CreditHandle>
               <lis:Id>101086</lis:Id>
               <lis:ProviderId>2</lis:ProviderId>
            </lis:CreditHandle>
            <lis:MetaData>
               <lis:CelebrityMetaData>None</lis:CelebrityMetaData>
            </lis:MetaData>
            <lis:Format xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:ServiceId>360861</lis:ServiceId>
            <lis:StartDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:Duration>10080</lis:Duration>
            <lis:InProgress>true</lis:InProgress>
            <lis:TitleType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:CopyType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:IncludeCreditsForEpisodes xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:ImageCount xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
         </lis:request>
      </lis:GetCelebrityDetails>
   </soapenv:Body>
</soapenv:Envelope>

Here's the response to this request, but to reduce the length only 2 of the 54 ListingsAiring elements are shown.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <GetCelebrityDetailsResponse xmlns="http://api.rovicorp.com/v9/listings">
         <GetCelebrityDetailsResult>
            <RequestId xmlns="http://api.rovicorp.com/v9/common/types">709b30f9-b472-4fd8-8a25-5a6f6d170e25</RequestId>
            <TimeStamp xmlns="http://api.rovicorp.com/v9/common/types">2011-06-10T19:50:38.656Z</TimeStamp>
            <Status xmlns="http://api.rovicorp.com/v9/common/types">PNE</Status>
            <Errors xmlns="http://api.rovicorp.com/v9/common/types"/>
            <EndTimestamp xmlns="http://api.rovicorp.com/v9/common/types">2011-06-10T19:50:40.046Z</EndTimestamp>
            <Build xmlns="http://api.rovicorp.com/v9/common/types">CPS Phase v9 Build 9.5.1.8</Build>
            <Schedule>
               <Locale>en-US</Locale>
               <ServiceId>360861</ServiceId>
               <Name>Beverly Hills - Time Warner Cable- Walnut/Diamond Bar</Name>
               <ServiceType>Cable</ServiceType>
               <StartDate>2011-06-10T19:50:38.65611Z</StartDate>
               <Duration>10080</Duration>
               <TimeZones>
                  <TimeZoneInfo>
                     <StartDateTime>2011-03-13T10:00:00Z</StartDateTime>
                     <EndDateTime>2011-11-06T09:00:00Z</EndDateTime>
                     <Offset>-420</Offset>
                  </TimeZoneInfo>
               </TimeZones>
               <Airings>
                  <ListingsAiring>
                     <ProgramId>3395294</ProgramId>
                     <SeriesId>1745480</SeriesId>
                     <InstanceId xsi:nil="true"/>
                     <UnknownInstance>false</UnknownInstance>
                     <Title>Law &amp; Order: Special Victims Unit</Title>
                     <EpisodeTitle>Surveillance</EpisodeTitle>
                     <Copy>Detectives search for a stalker-rapist. Emily Deschanel, Nate Moony, Jennifer Laura Thompson.</Copy>
                     <AiringTime>2011-06-14T07:00:00Z</AiringTime>
                     <Duration>60</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</TVRating>
                     <Dolby>false</Dolby>
                     <DSS>false</DSS>
                     <HDLevel>HD Level Unknown</HDLevel>
                     <Sports>false</Sports>
                     <DVS>false</DVS>
                     <Category>Other</Category>
                     <Subcategory>drama</Subcategory>
                     <SourceId>708</SourceId>
                     <Channel>13</Channel>
                     <CallLetters>KCOP</CallLetters>
                     <SourceDisplayName>KCOP</SourceDisplayName>
                     <SourceLongName>KCOP</SourceLongName>
                     <TiVoSupported>true</TiVoSupported>
                     <ParentNetworkId>154</ParentNetworkId>
                     <IconAvailable>true</IconAvailable>
                     <ServiceId>360861</ServiceId>
                     <DvbTriplet/>
                     <SL>false</SL>
                     <Subtitles>false</Subtitles>
                  </ListingsAiring>
                  <ListingsAiring>
                     <ProgramId>3395293</ProgramId>
                     <SeriesId>1745480</SeriesId>
                     <InstanceId xsi:nil="true"/>
                     <UnknownInstance>false</UnknownInstance>
                     <Title>Law &amp; Order: Special Victims Unit</Title>
                     <EpisodeTitle>Popular</EpisodeTitle>
                     <Copy>A student claims she was sexually assaulted by a teacher. Brittany Slattery, Christopher Orr, Billy Kay.</Copy>
                     <AiringTime>2011-06-11T07:00:00Z</AiringTime>
                     <Duration>60</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</TVRating>
                     <Dolby>false</Dolby>
                     <DSS>false</DSS>
                     <HDLevel>HD Level Unknown</HDLevel>
                     <Sports>false</Sports>
                     <DVS>false</DVS>
                     <Category>Other</Category>
                     <Subcategory>drama</Subcategory>
                     <SourceId>708</SourceId>
                     <Channel>13</Channel>
                     <CallLetters>KCOP</CallLetters>
                     <SourceDisplayName>KCOP</SourceDisplayName>
                     <SourceLongName>KCOP</SourceLongName>
                     <TiVoSupported>true</TiVoSupported>
                     <ParentNetworkId>154</ParentNetworkId>
                     <IconAvailable>true</IconAvailable>
                     <ServiceId>360861</ServiceId>
                     <DvbTriplet/>
                     <SL>false</SL>
                     <Subtitles>false</Subtitles>
                  </ListingsAiring>
                </Airings>
            </Schedule>
         </GetCelebrityDetailsResult>
      </GetCelebrityDetailsResponse>
   </soap:Body>
</soap:Envelope>

Request Example 3

Request the list of credits and awards for Mark Harmon, including credits for episodes in a series.
  • Specify en-US in the Locale element.
  • In the CreditHandle element, specify the ID for Mark Harmon and specify 2 in the ProviderId element.
  • In the Metadata element, specify the data to be returned:
    • Credits
    • Awards
  • Specify true in the IncludeCreditsForEpisodes element.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:typ="http://api.rovicorp.com/v9/common/types" xmlns:lis="http://api.rovicorp.com/v9/listings">
   <soapenv:Header>
      <typ:AuthHeader>
         <typ:UserName>username</typ:UserName>
         <typ:Password>password</typ:Password>
      </typ:AuthHeader>
   </soapenv:Header>
   <soapenv:Body>
      <lis:GetCelebrityDetails>
         <!--Optional:-->
         <lis:request>
            <lis:Locale>en-US</lis:Locale>
            <lis:CreditHandle>
               <lis:Id>100857</lis:Id>
               <lis:ProviderId>2</lis:ProviderId>
            </lis:CreditHandle>
            <lis:MetaData>
               <lis:CelebrityMetaData>Credits</lis:CelebrityMetaData>
               <lis:CelebrityMetaData>Awards</lis:CelebrityMetaData>
            </lis:MetaData>
            <lis:Format xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:ServiceId xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:StartDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:Duration xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:InProgress xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:TitleType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:CopyType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:IncludeCreditsForEpisodes>true</lis:IncludeCreditsForEpisodes>
            <lis:ImageCount xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
         </lis:request>
      </lis:GetCelebrityDetails>
   </soapenv:Body>
</soapenv:Envelope>

Here's the response to this request, but to reduce the length only the first 2 of the 1979 CelebrityCredit elements are shown.

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <GetCelebrityDetailsResponse xmlns="http://services.macrovision.com/v9/listings">
         <GetCelebrityDetailsResult>
            <RequestId xmlns="http://services.macrovision.com/v9/common/types">ce164030-bfad-4949-9029-b5c3b5f92644</RequestId>
            <TimeStamp xmlns="http://services.macrovision.com/v9/common/types">2012-03-28T00:32:25.984Z</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-28T00:32:37.109Z</EndTimestamp>
            <Build xmlns="http://services.macrovision.com/v9/common/types">CPS Phase v9 Build 9.9.3.1</Build>
            <Celebrity DataAvailabilityFlags="12">
               <CreditHandle>
                  <Id>100857</Id>
                  <ProviderId>2</ProviderId>
               </CreditHandle>
               <Factsheets/>
               <Awards>
                  <Award Title="Chicago Hope" Type="Screen Actors Guild Awards" Medium="None" Category="Outstanding Performance by an Ensemble in a Drama Series" Year="1997" IsWinner="false" DataAvailabilityFlags="478">
                     <ProgramHandle>
                        <Id>3653</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Series</ProgramType>
                  </Award>
                  <Award Title="Chicago Hope" Type="Screen Actors Guild Awards" Medium="None" Category="Outstanding Performance by an Ensemble in a Drama Series" Year="1996" IsWinner="false" DataAvailabilityFlags="478">
                     <ProgramHandle>
                        <Id>3653</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Series</ProgramType>
                  </Award>
                  <Award Title="Reasonable Doubts" Type="Golden Globe" Medium="TV" Category="Best Performance by an Actor in a Television Series - Drama" Year="1993" IsWinner="false" DataAvailabilityFlags="282">
                     <ProgramHandle>
                        <Id>426053</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Series</ProgramType>
                  </Award>
                  <Award Title="Reasonable Doubts" Type="Golden Globe" Medium="Film" Category="Best Performance by an Actor in a Television Series - Drama" Year="1993" IsWinner="false" DataAvailabilityFlags="282">
                     <ProgramHandle>
                        <Id>426053</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Series</ProgramType>
                  </Award>
                  <Award Title="Reasonable Doubts" Type="Golden Globe" Medium="TV" Category="Best Performance by an Actor in a Television Series - Drama" Year="1992" IsWinner="false" DataAvailabilityFlags="282">
                     <ProgramHandle>
                        <Id>426053</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Series</ProgramType>
                  </Award>
                  <Award Title="Reasonable Doubts" Type="Golden Globe" Medium="Film" Category="Best Performance by an Actor in a Television Series - Drama" Year="1992" IsWinner="false" DataAvailabilityFlags="282">
                     <ProgramHandle>
                        <Id>426053</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Series</ProgramType>
                  </Award>
                  <Award Title="After the Promise" Type="Golden Globe" Medium="TV" Category="Best Performance by an Actor in a Miniseries or Motion Picture Made for Television" Year="1988" IsWinner="false" DataAvailabilityFlags="26">
                     <ProgramHandle>
                        <Id>1199518</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Movie</ProgramType>
                  </Award>
                  <Award Title="After the Promise" Type="Golden Globe" Medium="Film" Category="Best Performance by an Actor in a Miniseries or Motion Picture Made for Television" Year="1988" IsWinner="false" DataAvailabilityFlags="26">
                     <ProgramHandle>
                        <Id>1199518</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Movie</ProgramType>
                  </Award>
                  <Award Title="The Deliberate Stranger" Type="Golden Globe" Medium="TV" Category="Best Performance by an Actor in a Miniseries or Motion Picture Made for Television" Year="1987" IsWinner="false" DataAvailabilityFlags="91">
                     <ProgramHandle>
                        <Id>1207579</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Movie</ProgramType>
                  </Award>
                  <Award Title="The Deliberate Stranger" Type="Golden Globe" Medium="Film" Category="Best Performance by an Actor in a Miniseries or Motion Picture Made for Television" Year="1987" IsWinner="false" DataAvailabilityFlags="91">
                     <ProgramHandle>
                        <Id>1207579</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Movie</ProgramType>
                  </Award>
                  <Award Title="Eleanor and Franklin: The White House Years" Type="Emmy" Medium="TV" Category="Outstanding Performance by a Supporting Actor in a Comedy or Drama Special" Year="1977" IsWinner="false" DataAvailabilityFlags="90">
                     <ProgramHandle>
                        <Id>4136501</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <IsCelebrity>true</IsCelebrity>
                     <ProgramType>Movie</ProgramType>
                  </Award>
               </Awards>
               <AKAs/>
               <Relatives/>
               <Credits>
                  <CelebrityCredit DataAvailabilityFlags="22">
                     <CreditHandle>
                        <Id>100857</Id>
                        <ProviderId>2</ProviderId>
                     </CreditHandle>
                     <ProgramHandle>
                        <Id>19815410</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <SeriesId>3899298</SeriesId>
                     <Title>NCIS</Title>
                     <EpisodeTitle>Enemy on the Hill</EpisodeTitle>
                     <ProgramType>Episode</ProgramType>
                     <Category>Other</Category>
                     <ReleaseYear>2011</ReleaseYear>
                     <CreditName>Mark Harmon</CreditName>
                     <PartName>Leroy Jethro Gibbs</PartName>
                     <CreditType>Action Director</CreditType>
                     <StartYear xsi:nil="true"/>
                     <EndYear xsi:nil="true"/>
                     <CopyText>A decorated naval officer is targeted by a contract killer; and Abby volunteers for kidney donation and learns something new about her family during the tests.</CopyText>
                     <Image>
                        <ImageUrl>http://actual-url-concealed.jpg</ImageUrl>
                        <ImageUseType xsi:nil="true"/>
                        <ImageId>5935512</ImageId>
                        <ImageTitle>NCIS</ImageTitle>
                        <ImageCaption>Brett Tucker and Cote de Pablo</ImageCaption>
                        <ObjectId>19815410</ObjectId>
                        <ObjectType>Program</ObjectType>
                        <ObjectName>NCIS</ObjectName>
                        <Relevancy>true</Relevancy>
                        <ImageCredit>Sonja Flemming/CBS</ImageCredit>
                        <ImageCreditDisplay xsi:nil="true"/>
                        <ImageCastWeight>5.33</ImageCastWeight>
                        <ImageZoomLevel>2</ImageZoomLevel>
                        <ImageHeadcount>2</ImageHeadcount>
                        <ImageType>Program: Key</ImageType>
                        <ImageFormat>jpg</ImageFormat>
                        <ImageHorizontalResolution>140</ImageHorizontalResolution>
                        <ImageVerticalResolution>105</ImageVerticalResolution>
                        <ImageMaintainAspectFlag xsi:nil="true"/>
                        <ImageExpiryDateTime xsi:nil="true"/>
                        <LastUpdate>2011-10-05T13:41:58.29Z</LastUpdate>
                        <ImageFormatId>36</ImageFormatId>
                        <Orientation>Landscape</Orientation>
                        <AspectRatio>4:3</AspectRatio>
                        <ImageOwner>Sonja Flemming/CBS</ImageOwner>
                        <ParentImageId>16935061</ParentImageId>
                        <MaxImageScale>28</MaxImageScale>
                     </Image>
                     <StarRating xsi:nil="true"/>
                     <ParentalRatings>
                        <ParentalRating>
                           <RatingType>US TV</RatingType>
                           <Rating>TV-PG@LV</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>CTV</RatingType>
                           <Rating>PG</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>FCTV</RatingType>
                           <Rating>None</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>Germany TV</RatingType>
                           <Rating>FSK: 3</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>Netherlands TV</RatingType>
                           <Rating>12</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>Spain TV</RatingType>
                           <Rating>7</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>Denmark TV</RatingType>
                           <Rating>None</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>Poland TV</RatingType>
                           <Rating>12</Rating>
                           <Reasons/>
                        </ParentalRating>
                     </ParentalRatings>
                     <ProgramLanguage>English</ProgramLanguage>
                     <FirstAirDate xsi:nil="true"/>
                     <LastAirDate xsi:nil="true"/>
                     <NumberOfEpisodes>0</NumberOfEpisodes>
                  </CelebrityCredit>
                  <CelebrityCredit DataAvailabilityFlags="22">
                     <CreditHandle>
                        <Id>100857</Id>
                        <ProviderId>2</ProviderId>
                     </CreditHandle>
                     <ProgramHandle>
                        <Id>20227641</Id>
                        <ProviderId>2</ProviderId>
                     </ProgramHandle>
                     <SeriesId>3899298</SeriesId>
                     <Title>NCIS</Title>
                     <EpisodeTitle>Secrets</EpisodeTitle>
                     <ProgramType>Episode</ProgramType>
                     <Category>Other</Category>
                     <ReleaseYear>2012</ReleaseYear>
                     <CreditName>Mark Harmon</CreditName>
                     <PartName>Leroy Jethro Gibbs</PartName>
                     <CreditType>Actor</CreditType>
                     <StartYear xsi:nil="true"/>
                     <EndYear xsi:nil="true"/>
                     <CopyText>DiNozzo is forced to work with his ex-fiancée when a captain's death is linked to a secret society of superheroes.</CopyText>
                     <Image>
                        <ImageUrl>http://actual-url-concealed.jpg</ImageUrl>
                        <ImageUseType xsi:nil="true"/>
                        <ImageId>7871409</ImageId>
                        <ImageTitle>NCIS</ImageTitle>
                        <ImageCaption>Allison McAtee, Shannon McClung, Sean Murray, Pauley Perrette and Michael Weatherly</ImageCaption>
                        <ObjectId>20227641</ObjectId>
                        <ObjectType>Program</ObjectType>
                        <ObjectName>NCIS</ObjectName>
                        <Relevancy>true</Relevancy>
                        <ImageCredit>Ron P. Jaffe/CBS</ImageCredit>
                        <ImageCreditDisplay xsi:nil="true"/>
                        <ImageCastWeight>2.47</ImageCastWeight>
                        <ImageZoomLevel>4</ImageZoomLevel>
                        <ImageHeadcount>5</ImageHeadcount>
                        <ImageType>Program: Key</ImageType>
                        <ImageFormat>jpg</ImageFormat>
                        <ImageHorizontalResolution>140</ImageHorizontalResolution>
                        <ImageVerticalResolution>105</ImageVerticalResolution>
                        <ImageMaintainAspectFlag xsi:nil="true"/>
                        <ImageExpiryDateTime xsi:nil="true"/>
                        <LastUpdate>2012-02-08T07:39:37.93Z</LastUpdate>
                        <ImageFormatId>36</ImageFormatId>
                        <Orientation>Landscape</Orientation>
                        <AspectRatio>4:3</AspectRatio>
                        <ImageOwner>Ron P. Jaffe/CBS</ImageOwner>
                        <ParentImageId>16967534</ParentImageId>
                        <MaxImageScale>7.91</MaxImageScale>
                     </Image>
                     <StarRating xsi:nil="true"/>
                     <ParentalRatings>
                        <ParentalRating>
                           <RatingType>US TV</RatingType>
                           <Rating>None</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>CTV</RatingType>
                           <Rating>PG</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>FCTV</RatingType>
                           <Rating>None</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>Germany TV</RatingType>
                           <Rating>FSK: 3</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>Netherlands TV</RatingType>
                           <Rating>12</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>Spain TV</RatingType>
                           <Rating>7</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>Denmark TV</RatingType>
                           <Rating>None</Rating>
                           <Reasons/>
                        </ParentalRating>
                        <ParentalRating>
                           <RatingType>Poland TV</RatingType>
                           <Rating>12</Rating>
                           <Reasons/>
                        </ParentalRating>
                     </ParentalRatings>
                     <ProgramLanguage>English</ProgramLanguage>
                     <FirstAirDate xsi:nil="true"/>
                     <LastAirDate xsi:nil="true"/>
                     <NumberOfEpisodes>0</NumberOfEpisodes>
                  </CelebrityCredit>
               </Credits>
               <Images/>
               <IsCelebrity>true</IsCelebrity>
            </Celebrity>
         </GetCelebrityDetailsResult>
      </GetCelebrityDetailsResponse>
   </soap:Body>
</soap:Envelope>

Request Example 4

Request up to 25 JPG images of Ice-T alone that fit a bounding box of 240 by 320 pixels.
  • Specify en-US in the Locale element.
  • In the CreditHandle element, specify the ID for Ice-T and specify 2 in the ProviderId element.
  • In the Metadata element, specify Images.
  • In the Image element, specify 1 in the ImageHeadcount element and 90 in the ImageFormatId element.
  • Specify 25 in the ImageCount element.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:typ="http://api.rovicorp.com/v9/common/types" xmlns:lis="http://api.rovicorp.com/v9/listings">
   <soapenv:Header>
      <typ:AuthHeader>
         <typ:UserName>username</typ:UserName>
         <typ:Password>password</typ:Password>
      </typ:AuthHeader>
   </soapenv:Header>
   <soapenv:Body>
      <lis:GetCelebrityDetails>
         <lis:request>
            <lis:Locale>en-US</lis:Locale>
            <lis:CreditHandle>
               <lis:Id>101086</lis:Id>
               <lis:ProviderId>2</lis:ProviderId>
            </lis:CreditHandle>
            <lis:MetaData>
               <lis:CelebrityMetaData>Images</lis:CelebrityMetaData>
            </lis:MetaData>
            <lis:Format xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:ServiceId xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:StartDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:Duration xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:InProgress xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:TitleType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:CopyType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:Image>
               <lis:ImageHeadcount>1</lis:ImageHeadcount>
               <lis:ImageFormatId>90</lis:ImageFormatId>
            </lis:Image>
            <lis:IncludeCreditsForEpisodes xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <lis:ImageCount>25</lis:ImageCount>
         </lis:request>
      </lis:GetCelebrityDetails>
   </soapenv:Body>
</soapenv:Envelope>

Here's the response to this request, but to reduce the length only the first 3 of the 12 Image elements returned are shown.

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <GetCelebrityDetailsResponse xmlns="http://services.macrovision.com/v9/listings">
         <GetCelebrityDetailsResult>
            <RequestId xmlns="http://services.macrovision.com/v9/common/types">3f6817ea-b523-4156-817d-58814bc6bcdd</RequestId>
            <TimeStamp xmlns="http://services.macrovision.com/v9/common/types">2012-03-28T01:22:57.065Z</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-28T01:22:57.097Z</EndTimestamp>
            <Build xmlns="http://services.macrovision.com/v9/common/types">CPS Phase v9 Build 9.9.3.1</Build>
            <Celebrity DataAvailabilityFlags="12">
               <CreditHandle>
                  <Id>101086</Id>
                  <ProviderId>2</ProviderId>
               </CreditHandle>
               <Factsheets/>
               <Awards/>
               <AKAs/>
               <Relatives/>
               <Credits/>
               <Images>
                  <Image>
                     <ImageUrl>http://actual-url-concealed.jpg</ImageUrl>
                     <ImageUseType xsi:nil="true"/>
                     <ImageId>3600410</ImageId>
                     <ImageTitle>Ice-T</ImageTitle>
                     <ImageCaption>NEW YORK - SEPTEMBER 15: Ice T attends the Baby Phat &amp; KLS Collection fashion show at Roseland Ballroom on September 15, 2009 in New York, New York.</ImageCaption>
                     <ObjectId>101086</ObjectId>
                     <ObjectType>Credit</ObjectType>
                     <ObjectName>Ice-T;Rapper; Actor</ObjectName>
                     <Relevancy>true</Relevancy>
                     <ImageCredit>Amy Sussman/Getty Images Entertainment/Getty Images</ImageCredit>
                     <ImageCreditDisplay xsi:nil="true"/>
                     <ImageCastWeight xsi:nil="true"/>
                     <ImageZoomLevel>1</ImageZoomLevel>
                     <ImageHeadcount>1</ImageHeadcount>
                     <ImageType>Celebrity</ImageType>
                     <ImageFormat>jpg</ImageFormat>
                     <ImageHorizontalResolution>240</ImageHorizontalResolution>
                     <ImageVerticalResolution>304</ImageVerticalResolution>
                     <ImageMaintainAspectFlag xsi:nil="true"/>
                     <ImageExpiryDateTime xsi:nil="true"/>
                     <LastUpdate>2010-01-25T13:16:24.403Z</LastUpdate>
                     <ImageFormatId>90</ImageFormatId>
                     <Orientation>Portrait</Orientation>
                     <AspectRatio>4:5</AspectRatio>
                     <ParentImageId>16854381</ParentImageId>
                     <ProgramTitle>Ice-T</ProgramTitle>
                     <MaxImageScale>10.14</MaxImageScale>
                  </Image>
                  <Image>
                     <ImageUrl>http://actual-url-concealed.jpg</ImageUrl>
                     <ImageUseType xsi:nil="true"/>
                     <ImageId>3600411</ImageId>
                     <ImageTitle>Ice-T</ImageTitle>
                     <ImageCaption>NEW YORK - OCTOBER 05: Musician /actor Ice-T attends The Cinema Society and Target screening of 'Good Hair' at the IFC Center on October 5, 2009 in New York City.</ImageCaption>
                     <ObjectId>101086</ObjectId>
                     <ObjectType>Credit</ObjectType>
                     <ObjectName>Ice-T;Rapper; Actor</ObjectName>
                     <Relevancy>true</Relevancy>
                     <ImageCredit>Stephen Lovekin/Getty Images Entertainment/Getty Images</ImageCredit>
                     <ImageCreditDisplay xsi:nil="true"/>
                     <ImageCastWeight xsi:nil="true"/>
                     <ImageZoomLevel>2</ImageZoomLevel>
                     <ImageHeadcount>1</ImageHeadcount>
                     <ImageType>Celebrity</ImageType>
                     <ImageFormat>jpg</ImageFormat>
                     <ImageHorizontalResolution>204</ImageHorizontalResolution>
                     <ImageVerticalResolution>320</ImageVerticalResolution>
                     <ImageMaintainAspectFlag xsi:nil="true"/>
                     <ImageExpiryDateTime xsi:nil="true"/>
                     <LastUpdate>2010-01-25T13:24:58.683Z</LastUpdate>
                     <ImageFormatId>90</ImageFormatId>
                     <Orientation>Portrait</Orientation>
                     <AspectRatio>2:3</AspectRatio>
                     <ParentImageId>16854388</ParentImageId>
                     <ProgramTitle>Ice-T</ProgramTitle>
                     <MaxImageScale>8.34</MaxImageScale>
                  </Image>
                  <Image>
                     <ImageUrl>http://actual-url-concealed.jpg</ImageUrl>
                     <ImageUseType xsi:nil="true"/>
                     <ImageId>3600406</ImageId>
                     <ImageTitle>Ice-T</ImageTitle>
                     <ImageCaption>JERSEY CITY, NJ - AUGUST 01: Rapper Ice-T performs on stage during the 2009 All Points West Music &amp; Arts Festival at Liberty State Park on August 1, 2009 in Jersey City, New Jersey.</ImageCaption>
                     <ObjectId>101086</ObjectId>
                     <ObjectType>Credit</ObjectType>
                     <ObjectName>Ice-T;Rapper; Actor</ObjectName>
                     <Relevancy>true</Relevancy>
                     <ImageCredit>Bryan Bedder/Getty Images Entertainment/Getty Images</ImageCredit>
                     <ImageCreditDisplay xsi:nil="true"/>
                     <ImageCastWeight xsi:nil="true"/>
                     <ImageZoomLevel>3</ImageZoomLevel>
                     <ImageHeadcount>1</ImageHeadcount>
                     <ImageType>Celebrity</ImageType>
                     <ImageFormat>jpg</ImageFormat>
                     <ImageHorizontalResolution>240</ImageHorizontalResolution>
                     <ImageVerticalResolution>317</ImageVerticalResolution>
                     <ImageMaintainAspectFlag xsi:nil="true"/>
                     <ImageExpiryDateTime xsi:nil="true"/>
                     <LastUpdate>2010-01-25T13:29:17.357Z</LastUpdate>
                     <ImageFormatId>90</ImageFormatId>
                     <Orientation>Portrait</Orientation>
                     <AspectRatio>3:4</AspectRatio>
                     <ParentImageId>16854392</ParentImageId>
                     <ProgramTitle>Ice-T</ProgramTitle>
                     <MaxImageScale>10.58</MaxImageScale>
                  </Image>
               </Images>
               <IsCelebrity>true</IsCelebrity>
            </Celebrity>
         </GetCelebrityDetailsResult>
      </GetCelebrityDetailsResponse>
   </soap:Body>
</soap:Envelope>

Request Example 5

Request up to 50 different sizes and formats of the last image that was returned in Request Example 4, which is titled Leprechaun in the Hood.
  • Specify en-US in the Locale element.
  • In the CreditHandle element, specify the ID for Ice-T and specify 2 in the ProviderId element.
  • In the Metadata element, specify Images.
  • In the Image element, specify 16863170 in the ParentImageId element.
  • Specify 50 in the ImageCount element.
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <GetCelebrityDetailsResponse xmlns="http://services.macrovision.com/v9/listings">
         <GetCelebrityDetailsResult>
            <RequestId xmlns="http://services.macrovision.com/v9/common/types">97b03335-0a9e-43c3-b0f8-df5939a36143</RequestId>
            <TimeStamp xmlns="http://services.macrovision.com/v9/common/types">2012-03-28T01:18:09.438Z</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-28T01:18:09.454Z</EndTimestamp>
            <Build xmlns="http://services.macrovision.com/v9/common/types">CPS Phase v9 Build 9.9.3.1</Build>
            <Celebrity DataAvailabilityFlags="12">
               <CreditHandle>
                  <Id>101086</Id>
                  <ProviderId>2</ProviderId>
               </CreditHandle>
               <Factsheets/>
               <Awards/>
               <AKAs/>
               <Relatives/>
               <Credits/>
               <Images>
                  <Image>
                     <ImageUrl>http://actual-url-concealed.jpg</ImageUrl>
                     <ImageUseType xsi:nil="true"/>
                     <ImageId>1535366</ImageId>
                     <ImageTitle>Leprechaun in the Hood</ImageTitle>
                     <ImageCaption>Ice-T;Rapper</ImageCaption>
                     <ObjectId>101086</ObjectId>
                     <ObjectType>Credit</ObjectType>
                     <ObjectName>Ice-T;Rapper; Actor</ObjectName>
                     <Relevancy>true</Relevancy>
                     <ImageCreditDisplay xsi:nil="true"/>
                     <ImageCastWeight>3</ImageCastWeight>
                     <ImageZoomLevel>2</ImageZoomLevel>
                     <ImageHeadcount>1</ImageHeadcount>
                     <ImageType>Production: Key</ImageType>
                     <ImageFormat xsi:nil="true"/>
                     <ImageHorizontalResolution>838</ImageHorizontalResolution>
                     <ImageVerticalResolution>581</ImageVerticalResolution>
                     <ImageMaintainAspectFlag xsi:nil="true"/>
                     <ImageExpiryDateTime xsi:nil="true"/>
                     <LastUpdate>2010-03-19T15:29:07.087Z</LastUpdate>
                     <ImageFormatId>0</ImageFormatId>
                     <Orientation>Landscape</Orientation>
                     <AspectRatio>3:2</AspectRatio>
                     <ParentImageId>16863170</ParentImageId>
                     <ProgramTitle>Leprechaun in the Hood</ProgramTitle>
                     <MaxImageScale>100</MaxImageScale>
                  </Image>
                  <Image>
                     <ImageUrl>http://actual-url-concealed.jpg</ImageUrl>
                     <ImageUseType xsi:nil="true"/>
                     <ImageId>1535397</ImageId>
                     <ImageTitle>Leprechaun in the Hood</ImageTitle>
                     <ImageCaption>Ice-T;Rapper</ImageCaption>
                     <ObjectId>101086</ObjectId>
                     <ObjectType>Credit</ObjectType>
                     <ObjectName>Ice-T;Rapper; Actor</ObjectName>
                     <Relevancy>true</Relevancy>
                     <ImageCreditDisplay xsi:nil="true"/>
                     <ImageCastWeight>3</ImageCastWeight>
                     <ImageZoomLevel>2</ImageZoomLevel>
                     <ImageHeadcount>1</ImageHeadcount>
                     <ImageType>Production: Key</ImageType>
                     <ImageFormat>jpg</ImageFormat>
                     <ImageHorizontalResolution>500</ImageHorizontalResolution>
                     <ImageVerticalResolution>346</ImageVerticalResolution>
                     <ImageMaintainAspectFlag xsi:nil="true"/>
                     <ImageExpiryDateTime xsi:nil="true"/>
                     <LastUpdate>2010-03-19T15:29:07.087Z</LastUpdate>
                     <ImageFormatId>16</ImageFormatId>
                     <Orientation>Landscape</Orientation>
                     <AspectRatio>3:2</AspectRatio>
                     <ParentImageId>16863170</ParentImageId>
                     <ProgramTitle>Leprechaun in the Hood</ProgramTitle>
                     <MaxImageScale>59.67</MaxImageScale>
                  </Image>
               </Images>
               <IsCelebrity>true</IsCelebrity>
            </Celebrity>
         </GetCelebrityDetailsResult>
      </GetCelebrityDetailsResponse>
   </soap:Body>
</soap:Envelope>

See Also

↑ Top

 
 
Personal tools