wiki:XmlRpcGetIMDBMovieDetails

GetIMDBMovieDetails

Intro

get details about given movie


Description

struct GetIMDBMovieDetails(string $token, string $imdbid)

Returns structure with movie information about given movie $imdbid containing movie title, release year, directors, cast, ...

All information is gathered from IMDb.


Parameters

struct(
  (string) [token],
  (string) [imdbid]
)
token (required)
token string identifying user's session, taken from LogIn output structure.
imdbid (required)
IMDb ID of requested movie, can be taken from results of SearchMoviesOnIMDB()

Return Values

Output is returned in this structure:

struct(
  (string) [status],
  struct(
    (string) [id],
    (string) [title],
    (string) [year],
    (string) [cover],
    struct(
      (string) [<id>], (string) [id], ...
    ) [cast],
    struct(
      (string) [<id>], (string) [id], ...
    ) [directors],
    struct(
      (string) [<id>], (string) [id], ...
    ) [writers],
    (string) [awards],
    array(
      (string) [genre], (string) [genre], ...
    ) [genres],
    array(
      (string) [country], (string) [country], ...
    ) [country],
    array(
      (string) [language], (string) [language], ...
    ) [language],
    (string) [duration],
    array(
      (string) [certification], (string) [certification], ...
    ) [certification],
    (string) [tagline],
    (string) [plot],
    (string) [goofs],
    (string) [trivia],
    (string) [request_from]
  ) [data],
  (double) [seconds]
)

and contains these elements:

status
function result code, see list of status codes
data
structure containing movie information
seconds
time taken to execute this command on server

Implementations

There are currently no available sample implementations.


Changelog

Version 1: created this function


Examples

Input

<methodCall>
 <methodName>GetIMDBMovieDetails</methodName>
 <params>
  <param>
   <value><string>d0iot4l0teqk9nmn3s99bdhsh3</string></value>
  </param>
  <param>
   <value><string>0088763</string></value>
  </param>
 </params>
</methodCall>

Output

This structure might be incomplete (or extended later).

Not sure if these values are returned: rating, aka.

<methodResponse>
 <params>
  <param>
   <value>
    <struct>
     <member>
      <name>status</name>
      <value><string>200 OK</string></value>
     </member>
     <member>
      <name>data</name>
      <value>
       <struct>
        <member>
         <name>id</name>
         <value><string>0088763</string></value>
        </member>
        <member>
         <name>title</name>
         <value><string>Back to the Future</string></value>
        </member>
        <member>
         <name>year</name>
         <value><string>1985</string></value>
        </member>
        <member>
         <name>cover</name>
         <value><string>http://ia.media-imdb.com/images/M/MV5BMTkzNDQyMjc0OV5BMl5BanBnXkFtZTcwNDQ4MDYyMQ@@._V1._SX100_SY133_.jpg</string></value>
        </member>
        <member>
         <name>cast</name>
         <value>
          <struct>
           <member>
            <name>_0000150</name>
            <value><string>Michael J. Fox</string></value>
           </member>
           <member>
            <name>_0000502</name>
            <value><string>Christopher Lloyd</string></value>
           </member>
           <member>
            <name>_0000670</name>
            <value><string>Lea Thompson</string></value>
           </member>
           
           ... more cast members go here (if any) ...
            
          </struct>
         </value>
        </member>
        <member>
         <name>directors</name>
         <value>
          <struct>
           <member>
            <name>_0000709</name>
            <value><string>Robert Zemeckis</string></value>
           </member>
           
           ... more directors go here (if any) ...
           
          </struct>
         </value>
        </member>
        <member>
         <name>writers</name>
         <value>
          <struct>
           <member>
            <name>_0000709</name>
            <value><string>Robert Zemeckis</string></value>
           </member>
           <member>
            <name>_0301826</name>
            <value><string>Bob Gale</string></value>
           </member>
          </struct>
         </value>
        </member>
        <member>
         <name>awards</name>
         <value><string>Won Oscar. Another 12 wins &#38; 22 nominations</string></value>
        </member>
        <member>
         <name>genres</name>
         <value>
          <array>
           <data>
            <value><string>Adventure</string></value>
            <value><string>Comedy</string></value>
            <value><string>Sci-Fi</string></value>
            
            ... more genres go here (if any) ...
            
           </data>
          </array>
         </value>
        </member>
        <member>
         <name>country</name>
         <value>
          <array>
           <data>
            <value><string>USA</string></value>
           </data>
          </array>
         </value>
        </member>
        <member>
         <name>language</name>
         <value>
          <array>
           <data>
            <value><string>English</string></value>
           </data>
          </array>
         </value>
        </member>
        <member>
         <name>duration</name>
         <value><string>117 min</string></value>
        </member>
        <member>
         <name>certification</name>
         <value>
          <array>
           <data>
            <value><string>UK</string></value>
            <value><string>Italy</string></value>
            <value><string>Australia</string></value>
            <value><string>USA</string></value>
           </data>
          </array>
         </value>
        </member>
        <member>
         <name>tagline</name>
         <value><string>He's the only kid ever to get into trouble before he was born. [UK]</string></value>
        </member>
        <member>
         <name>plot</name>
         <value><string>In 1985, Doc Brown invented time travel, in 1955, Marty McFly accidentally prevented his parents from meeting, putting his own existence at stake.</string></value>
        </member>
        <member>
         <name>goofs</name>
         <value><string>Continuity: A picture on the table below Biff, and the candy in Biff's hand when he is talking to George about his car in 1985.</string></value>
        </member>
        <member>
         <name>trivia</name>
         <value><string>The space alien gag first appeared in the screenplay's third draft, with the primary difference being that it was to be done to Biff.</string></value>
        </member>
        <member>
         <name>request_from</name>
         <value><string>cache</string></value>
        </member>
       </struct>
      </value>
     </member>
     <member>
      <name>seconds</name>
      <value><double>0.535</double></value>
     </member>
    </struct>
   </value>
  </param>
 </params>
</methodResponse>

Notes

none yet


See also


Comments

add your comments, hints and suggestions here if you like ...


[Prev] Home [Next]

Last modified 10 years ago Last modified on Oct 12, 2008, 5:02:14 PM