V1.Metadata.Common:Movie

Jump to: navigation, search

Movie

Contains information about a movie.

Elements

NameTypeDescription
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 in order of AMG Movie ID. You can use the AMG Movie ID in a Name/Info request to return information about a director.
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.
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
producedBy String [ ] Companies that produced the movie.
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.
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, 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/>
    <movieId>V 10546</movieId>
  </ids>
  <title>The Commitment</title>
  <releaseYear>1976</releaseYear>
  <rating>4</rating>
  <duration>88</duration>
  <directors>
    <Director>
      <id>P 92310</id>
      <name>Richard Grand</name>
    </Director>
    <Director>
      <id>P164795</id>
      <name>Louis A. Shaffner</name>
    </Director>
  </directors>
  <countries xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <a:string>USA</a:string>
  </countries>
  <mpaa/>
  <flags xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <a:string>Questionable for Children</a:string>
  </flags>
  <genres>
    <Genre>
      <id>D 649</id>
      <name>Drama</name>
      <weight>5</weight>
    </Genre>
  </genres>
  <attributes xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true"/>
  <cast i:nil="true"/>
  <castUri>http://api.rovicorp.com/v1/movie/cast?format=xml&amp;apikey=apikey&amp;movieid=V++++10546</castUri>
  <crew i:nil="true"/>
  <crewUri>http://api.rovicorp.com/v1/movie/crew?format=xml&amp;apikey=apikey&amp;movieid=V++++10546</crewUri>
  <images i:nil="true"/>
  <imagesUri i:nil="true"/>
  <keywords i:nil="true"/>
  <keywordsUri>http://api.rovicorp.com/v1/movie/keywords?format=xml&amp;apikey=apikey&amp;movieid=V++++10546</keywordsUri>
  <moods i:nil="true"/>
  <moodsUri i:nil="true"/>
  <related i:nil="true"/>
  <relatedUri i:nil="true"/>
  <releases i:nil="true"/>
  <releasesUri i:nil="true"/>
  <review i:nil="true"/>
  <reviewUri i:nil="true"/>
  <similar i:nil="true"/>
  <similarUri i:nil="true"/>
  <synopsis i:nil="true"/>
  <synopsisUri>http://api.rovicorp.com/v1/movie/synopsis?format=xml&amp;apikey=apikey&amp;movieid=V++++10546</synopsisUri>
  <themes i:nil="true"/>
  <themesUri i:nil="true"/>
  <tones i:nil="true"/>
  <tonesUri i:nil="true"/>
  <types i:nil="true"/>
  <typesUri i:nil="true"/>
  <videos i:nil="true"/>
  <videosUri i:nil="true"/>
  <studio>Commitment Co./Indie</studio>
  <producedBy xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <a:string>Commitment Company</a:string>
    <a:string>Indie-Pix</a:string>
  </producedBy>
  <releasedBy xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true"/>
  <distributor xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true"/>
</Movie>

JSON Response Example

The following example has been formatted with extra spaces and carriage returns to make it easy to read.
{
  "ids":{
    "cosmoId":"",
    "movieId":"V   10546"
  },
  "title":"The Commitment",
  "releaseYear":"1976",
  "rating":4,
  "duration":88,
  "directors":[
    {
      "id":"P 92310",
      "name":"Richard Grand"
    },
    {
      "id":"P164795",
      "name":"Louis A. Shaffner"
    }
  ],
  "countries":[
    "USA"
  ],
  "mpaa":"",
  "flags":[
    "Questionable for Children"
  ],
  "genres":[
    {
      "id":"D  649",
      "name":"Drama",
      "weight":5
    }
  ],
  "attributes":null,
  "cast":null,
  "castUri":"http:\/\/api.rovicorp.com\/v1\/movie\/cast?format=json&apikey=apikey&movieid=V++++10546",
  "crew":null,
  "crewUri":"http:\/\/api.rovicorp.com\/v1\/movie\/crew?format=json&apikey=apikey&movieid=V++++10546",
  "images":null,
  "imagesUri":null,
  "keywords":null,
  "keywordsUri":"http:\/\/api.rovicorp.com\/v1\/movie\/keywords?format=json&apikey=apikey&movieid=V++++10546",
  "moods":null,
  "moodsUri":null,
  "related":null,
  "relatedUri":null,
  "releases":null,
  "releasesUri":null,
  "review":null,
  "reviewUri":null,
  "similar":null,
  "similarUri":null,
  "synopsis":null,
  "synopsisUri":"http:\/\/api.rovicorp.com\/v1\/movie\/synopsis?format=json&apikey=apikey&movieid=V++++10546",
  "themes":null,
  "themesUri":null,
  "tones":null,
  "tonesUri":null,
  "types":null,
  "typesUri":null,
  "videos":null,
  "videosUri":null,
  "studio":"Commitment Co.\/Indie",
  "producedBy":[
    "Commitment Company",
    "Indie-Pix"
  ],
  "releasedBy":null,
  "distributor":null
}
 
Retrieved from "http://prod-doc.rovicorp.com/mashery/index.php/V1.Metadata.Common:Movie"
Personal tools