Common/movie/v1.1/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.
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.

Genres are sorted in order of importance (highest to lowest weight) and, within the same weight, alphabetically by genre name.

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. Multiple sizes of each image are listed, from smallest to largest width. Images are returned in order of available image types:
  1. Poster Art
  2. Box Art
  3. Key Art
  4. Head Shot Key (for a key cast member)
  5. Proram: Key
  6. Group
  7. Production: Key
  8. Gallery Key
  9. Head Shot Key (for other cast members)
  10. Program Logo
  11. Any other image types available

The image type of each image is specified in the URL. For a description of image types, see the ImageType enumeration.

Within each image type returned, the most recent images are returned first.

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 9, 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
}
 
Retrieved from "http://prod-doc.rovicorp.com/mashery/index.php/Common/movie/v1.1/MovieSimilar"
Personal tools