V1.Metadata.Common:MovieSimilar

Jump to: navigation, search

MovieSimilar

Contains information about a movie similar to the one named in the request.

Elements

NameTypeDescription
directors Director [ ] Directors of the movie or TV series, listed in order of AMG Movie ID. You can use the AMG Movie ID in a Name/Info request to return information about a director.
duration Integer Run time in minutes.
genres Genre [ ] Genres that apply to the movie, along with a weighting that reflects the relative importance of each genre.
hasReview Boolean Whether a review of the movie is available: true or false.
ids ids All of the IDs that are recognized by the API for a movie. The possible IDs are:
  • cosmoId
  • movieId
images Image [ ] URLs to images of the movie, along with the resolution of each image.
mpaa String MPAA rating for the movie:
  • G
  • PG  
  • PG-13  
  • R
  • NC-17  
  • NR
  • Not rated
rating Integer An editorially assigned rating of the movie from 0 to 10, where 0 is no rating and higher numbers indicate a higher rating.
releaseYear String Year the movie was released.
studio String The company that filmed the movie.
title String Full title of the movie.
types MoviesType [ ] Subgenres that apply to the movie, along with weightings that reflect the relative importance of each.

XML Response Example

<MovieSimilar>
  <ids>
    <cosmoId>20538</cosmoId>
    <movieId>V 1971</movieId>
  </ids>
  <title>American Graffiti</title>
  <directors>
    <Director>
      <id>P100308</id>
      <name>George Lucas</name>
    </Director>
  </directors>
  <releaseYear>1973</releaseYear>
  <rating>9</rating>
  <mpaa>PG</mpaa>
  <images>
    <Image>
      <height>40</height>
      <width>26</width>
      <formatid>30</formatid>
      <url>http://actual-url-concealed.com</url>
      <author i:nil="true" />
      <copyrightOwner i:nil="true" />
    </Image>
    <Image>
      <height>50</height>
      <width>33</width>
      <formatid>26</formatid>
      <url>http://actual-url-concealed.com</url>
      <author i:nil="true" />
      <copyrightOwner i:nil="true" />
    </Image>
  </images>
  <genres>
    <Genre>
      <id>D 531</id>
      <name>Comedy Drama</name>
      <weight>5</weight>
    </Genre>
  </genres>
  <types>
    <MoviesType>
      <id>D 525</id>
      <name>Americana</name>
      <weight>7</weight>
    </MoviesType>
    <MoviesType>
      <id>D 959</id>
      <name>Coming-of-Age</name>
      <weight>7</weight>
    </MoviesType>
    <MoviesType>
      <id>D 1003</id>
      <name>Ensemble Film</name>
      <weight>5</weight>
    </MoviesType>
    <MoviesType>
      <id>D 541</id>
      <name>Period Film</name>
    <weight>5</weight>
    </MoviesType>
    <MoviesType>
      <id>D 621</id>
      <name>Teen Movie</name>
      <weight>5</weight>
    </MoviesType>
  </types>
  <studio>Universal/Universal</studio>
  <duration>109</duration>
  <hasReview>true</hasReview>
</MovieSimilar>

JSON Response Example

{
  "ids":{
    "cosmoId":"20538",
    "movieId":"V    1971"
  },
  "title":"American Graffiti",
  "directors":[
    {
      "id":"P100308",
      "name":"George Lucas"
    }
  ],
  "releaseYear":"1973",
  "rating":9,
  "mpaa":"PG",
  "images":[
    {
      "height":40,
      "width":26,
      "formatid":30,
      "url":"http:\/\/actual-url-concealed.com",
      "author":null,
      "copyrightOwner":null
    },
    {
      "height":50,
      "width":33,
      "formatid":26,
      "url":"http:\/\/actual-url-concealed.com",
      "author":null,
      "copyrightOwner":null
    },
  ]
  "genres":[
    {
      "id":"D  531",
      "name":"Comedy Drama",
      "weight":5
    }
  ],
  "types":[
    {
      "id":"D  525",
      "name":"Americana",
      "weight":7
    },
    {
      "id":"D  959",
      "name":"Coming-of-Age",
      "weight":7
    },
    {
      "id":"D  1003",
      "name":"Ensemble Film",
      "weight":5
    },
    {
      "id":"D  541",
      "name":"Period Film",
      "weight":5
    },
    {
      "id":"D  621",
      "name":"Teen Movie",
      "weight":5
    }
  ],
  "studio":"Universal\/Universal",
  "duration":109,
  "hasReview":true
}
 
Personal tools