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

• SearchMoviesOnIMDB()

---

Comments

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

---

[Prev] Home [Next]