Common/movie/v1.1/Movie

Jump to: navigation, search

Movie

Contains information about a movie.

Elements

NameTypeDescription
altTitle string Another title the movie or TV series is known by.

Note: This response is now deprecated and will be removed in a future release. Use include=alttitles or movie/alttitles instead.

altTitles MovieTitle [ ] Alternate and international titles for the movie or TV series, returned only if the request specified an include=alttitles argument.
altTitlesUri string The customized Movie/AltTitles request, returned only if alternate titles are available.
attributes string [ ] Attributes associated with the Movie:
  • Cult Film
  • High Artistic Quality
  • High Budget
  • High Historical Importance
  • High Production Values
  • Low Artistic Quality
  • Low Budget
  • Low Production Values
  • Sleeper
cast People [ ] Cast information and links to images, returned only if the request specified an include=cast argument.
castUri string The customized Movie/Cast request, returned only if cast data is available.
countries string [ ] List of countries the movie was released in.
crew People [ ] Crew names, roles, and images, returned only if the request specified an include=crew argument.
crewUri string The customized Movie/Crew request, returned only if crew information is available.
directors Director [ ] Directors of the movie or TV series, listed alphabetically in order of last name.
distributor string [ ] The company that distributed the movie.
duration integer Run time in minutes.
flags string [ ] Additional features and characteristics that apply to the movie:
  • Adult Humor
  • Adult Language
  • Adult Situations
  • Alcohol Consumption
  • Brief Nudity
  • Child Classic
  • Children in Peril
  • Drug Content
  • Excellent For Children
  • Gore
  • Graphic Violence
  • Mild Language
  • Mild Violence
  • Not For Children
  • Nudity
  • Profanity
  • Questionable for Children
  • Rape & Sexual Abuse
  • Scary Moments
  • Scatological Humor
  • Sci-Fi Violence
  • Sexual Situations
  • Slapstick Violence
  • Smoking
  • Strong Sexual Content
  • Substance Abuse
  • Suitable for Children
  • Suitable for Teens
  • Torture
  • Violence
  • War Violence
  • Watch With Your Kids
  • Watch With Your Teen
  • Western Violence
  • Youth Substance Use
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.

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, returned only if the request specified an include=images argument and your subscription level enables access to images.
imagesUri string The customized Movie/Images request, returned only if the data is available.
keywords Keyword [ ] Keywords for the plot structure of a movie or TV series, returned only if the request specified an include=keywords argument.
keywordsUri string The customized Movie/Keywords request, returned only if the data is available.
moods MoviesMood [ ] Terms that describe expressive characteristics of the movie, returned only if the request specified an include=moods argument.
moodsUri string The customized Movie/Moods request, returned only if the data is available.
mpaa string MPAA rating for the movie:
  • G
  • PG  
  • PG-13  
  • R
  • NC-17  
  • NR
  • Not rated
originCountries string [ ] Countries of origin as recognized by different legal jurisdictions. Principal locations of the companies or individuals that produced the movie or program and its accompanying material, such as scripts, synopses, shot lists, inventory lists, publicity material, production records, etc.
producedBy string [ ] Companies that produced the movie.
programType string Type of program:
  • Movie
  • Series
  • Season
  • Episode
  • One Time Only
  • Unknown
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.
related related Related movies, returned only if the request specified an include=related argument.
relatedUri string The customized Movie/Related request, returned only if the data is available.
releasedBy string [ ] The companies that released the movie.
releases MovieRelease [ ] DVD and other releases of the movie, returned only if the request specified an include=releases argument.
releasesUri string The customized Movie/Releases request, returned only if the data is available.
releaseYear string Year the movie was released.
review review A review of the movie, returned only if the request specified an include=review argument.
reviewUri string The customized Movie/Review request, returned only if the data is available.
similar MovieSimilar [ ] Similar movies to the movie named in the request, returned only if the request specified an include=similar argument.

Notice: This property is deprecated and will be removed from the API on a date to be announced.

similarUri string The customized Movie/Similar request, returned only if the data is available.

Notice: This property is deprecated and will be removed from the API on a date to be announced.

studio string The company that filmed the movie.
synopsis synopsis Synopsis of the plot, usually a complete summary of a movie or TV series, returned only if the request specified an include=synopsis argument.
synopsisUri string The customized Movie/Synopsis request, returned only if the data is available.
themes MoviesTheme [ ] Topics and circumstances that motivate or fit with the movie, returned only if the request specified an include=themes argument.
themesUri string The customized Movie/Themes request, returned only if the data is available.
title string Full title of the movie.
tones MoviesTone [ ] Feelings that motivate or fit with the movie, returned only if the request specified an include=tones argument.
tonesUri string The customized Movie/Tones request, returned only if the data is available.
types MoviesType [ ] Subgenres that apply to the movie, returned only if the request specified an include=types argument.
typesUri string The customized Movie/Types request, returned only if the data is available.
videos Video [ ] Data for constructing links to trailers for the movie, returned only if the request specified an include=videos argument.
videosUri string The customized Movie/Videos request, returned only if data is available.

XML Response Example

<movie>
    <ids>
        <cosmoId>262068</cosmoId>
        <movieId>V 20546</movieId>
    </ids>
    <title>Grease</title>
    <altTitle />
    <altTitles i:nil="true" />
    <altTitlesUri i:nil="true" />
    <programType>Movie</programType>
    <releaseYear>1978</releaseYear>
    <rating>8</rating>
    <duration>110</duration>
    <directors>
        <Director>
            <id>P 97609</id>
            <name>Randal Kleiser</name>
        </Director>
    </directors>
    <countries>
        <a:string>USA</a:string>
    </countries>
    <mpaa>PG</mpaa>
    <flags>
        <a:string>Adult Language</a:string>
        <a:string>Adult Situations</a:string>
        <a:string>Suitable for Children</a:string>
    </flags>
    <genres>
        <Genre>
            <id>D 655</id>
            <name>Musical</name>
            <weight>7</weight>
        </Genre>
    </genres>
    <attributes i:nil="true" />
    <cast i:nil="true" />
    <castUri>http://api.rovicorp.com/data/v1.1/movie/cast?format=xml&apikey=apikey&movieid=V++++20546</castUri>
    <crew i:nil="true" />
    <crewUri>http://api.rovicorp.com/data/v1.1/movie/crew?format=xml&apikey=apikey&movieid=V++++20546</crewUri>
    <images i:nil="true" />
    <imagesUri>http://api.rovicorp.com/data/v1.1/movie/images?format=xml&apikey=apikey&movieid=V++++20546</imagesUri>
    <keywords i:nil="true" />
    <keywordsUri>http://api.rovicorp.com/data/v1.1/movie/keywords?format=xml&apikey=apikey&movieid=V++++20546</keywordsUri>
    <moods i:nil="true" />
    <moodsUri>http://api.rovicorp.com/data/v1.1/movie/moods?format=xml&apikey=apikey&movieid=V++++20546</moodsUri>
    <related i:nil="true" />
    <relatedUri>http://api.rovicorp.com/data/v1.1/movie/related?format=xml&apikey=apikey&movieid=V++++20546</relatedUri>
    <releases i:nil="true" />
    <releasesUri>http://api.rovicorp.com/data/v1.1/movie/releases?format=xml&apikey=apikey&movieid=V++++20546</releasesUri>
    <review i:nil="true" />
    <reviewUri>http://api.rovicorp.com/data/v1.1/movie/review?format=xml&apikey=apikey&movieid=V++++20546</reviewUri>
    <similar i:nil="true" />
    <similarUri>http://api.rovicorp.com/data/v1.1/movie/similar?format=xml&apikey=apikey&movieid=V++++20546</similarUri>
    <synopsis i:nil="true" />
    <synopsisUri>http://api.rovicorp.com/data/v1.1/movie/synopsis?format=xml&apikey=apikey&movieid=V++++20546</synopsisUri>
    <themes i:nil="true" />
    <themesUri>http://api.rovicorp.com/data/v1.1/movie/themes?format=xml&apikey=apikey&movieid=V++++20546</themesUri>
    <tones i:nil="true" />
    <tonesUri>http://api.rovicorp.com/data/v1.1/movie/tones?format=xml&apikey=apikey&movieid=V++++20546</tonesUri>
    <types i:nil="true" />
    <typesUri>http://api.rovicorp.com/data/v1.1/movie/types?format=xml&apikey=apikey&movieid=V++++20546</typesUri>
    <videos i:nil="true" />
    <videosUri>http://api.rovicorp.com/data/v1.1/movie/videos?format=xml&apikey=apikey&movieid=V++++20546</videosUri>
    <studio>Paramount/Paramount/Robert</studio>
    <producedBy>
        <a:string>Paramount</a:string>
    </producedBy>
    <releasedBy i:nil="true" />
    <distributor i:nil="true" />
    <originCountries>
        <a:string>United States</a:string>
    </originCountries>
    <schemaVersion>1</schemaVersion>
</movie>

JSON Response Example

The following example has been formatted with extra spaces and carriage returns to make it easy to read.
{
   "ids":{
      "cosmoId":"262068",
      "movieId":"V 20546"
   },
   "title":"Grease",
   "altTitle":"",
   "altTitles":null,
   "altTitlesUri":null,
   "programType":"Movie",
   "releaseYear":"1978",
   "rating":8,
   "duration":110,
   "directors":[
      {
         "id":"P 97609",
         "name":"Randal Kleiser"
      }
   ],
   "countries":[
      "USA"
   ],
   "mpaa":"PG",
   "flags":[
      "Adult Language",
      "Adult Situations",
      "Suitable for Children"
   ],
   "genres":[
      {
         "id":"D 655",
         "name":"Musical",
         "weight":7
      }
   ],
   "attributes":null,
   "cast":null,
   "castUri":"http://api.rovicorp.com/data/v1.1/movie/cast?format=json&apikey=apikey&movieid=V++++20546",
   "crew":null,
   "crewUri":"http://api.rovicorp.com/data/v1.1/movie/crew?format=json&apikey=apikey&movieid=V++++20546",
   "images":null,
   "imagesUri":"http://api.rovicorp.com/data/v1.1/movie/images?format=json&apikey=apikey&movieid=V++++20546",
   "keywords":null,
   "keywordsUri":"http://api.rovicorp.com/data/v1.1/movie/keywords?format=json&apikey=apikey&movieid=V++++20546",
   "moods":null,
   "moodsUri":"http://api.rovicorp.com/data/v1.1/movie/moods?format=json&apikey=apikey&movieid=V++++20546",
   "related":null,
   "relatedUri":"http://api.rovicorp.com/data/v1.1/movie/related?format=json&apikey=apikey&movieid=V++++20546",
   "releases":null,
   "releasesUri":"http://api.rovicorp.com/data/v1.1/movie/releases?format=json&apikey=apikey&movieid=V++++20546",
   "review":null,
   "reviewUri":"http://api.rovicorp.com/data/v1.1/movie/review?format=json&apikey=apikey&movieid=V++++20546",
   "similar":null,
   "similarUri":"http://api.rovicorp.com/data/v1.1/movie/similar?format=json&apikey=apikey&movieid=V++++20546",
   "synopsis":null,
   "synopsisUri":"http://api.rovicorp.com/data/v1.1/movie/synopsis?format=json&apikey=apikey&movieid=V++++20546",
   "themes":null,
   "themesUri":"http://api.rovicorp.com/data/v1.1/movie/themes?format=json&apikey=apikey&movieid=V++++20546",
   "tones":null,
   "tonesUri":"http://api.rovicorp.com/data/v1.1/movie/tones?format=json&apikey=apikey&movieid=V++++20546",
   "types":null,
   "typesUri":"http://api.rovicorp.com/data/v1.1/movie/types?format=json&apikey=apikey&movieid=V++++20546",
   "videos":null,
   "videosUri":"http://api.rovicorp.com/data/v1.1/movie/videos?format=json&apikey=apikey&movieid=V++++20546",
   "studio":"Paramount/Paramount/Robert",
   "producedBy":[
      "Paramount"
   ],
   "releasedBy":null,
   "distributor":null,
   "originCountries":[
      "United States"
   ],
   "schemaVersion":1
}
 
Retrieved from "http://prod-doc.rovicorp.com/mashery/index.php/Common/movie/v1.1/Movie"
Personal tools