Movies
Movie versions
/movies/
Returns detailed metadata about all versions of a specified movie. Versions may differ by details such as format (e.g., 3D, IMAX), runtime, or language. Response metadata will include cast, crew, and awards information.
Request Parameters
| Parameter | Mandatory? | Description |
|---|---|---|
| rootId | Yes | Root ID, which can be obtained via airings, movies, or celebrity APIs |
| imageSize | No | Valid values are: Sm, Md, Lg, Ms. If not specified, defaults to Md. If requested image size is not available, generic image will be returned. |
| imageText | No | Boolean indicating preference for image types with text (banners) or without text (iconics). If requested preference is not available, image selection will continue to next type (banner/iconic), before finally returning generic if no image found. Defaults to true for text preference. |
| descriptionLang | No | Filter results based on the specified description language. Use IETF language tags (2-letter abbreviations, with optional 2-letter region extensions). When not provided, returns English versions, or if no English descriptions available, returns versions with descriptionLang of primary TMS ID. |
| api_key | Yes | 24-character key obtained during application registration |
Response Body
| Response | Type | Description |
|---|---|---|
| Movie metadata | Program [ ] | Detailed information regarding all versions of specified movie. |
Sample Request
Return movie metadata for all versions of movie; rootId is acquired from response data of other APIs (e.g., celebrity lookup shows movie data in mediography).
http://data.tmsapi.com/v1.1/movies/9991634/versions?api_key=1234567890
Sample Response
TMS IDs are unique for each movie version. Ratings could vary by version; for example, Director’s Cut versions are often rated higher than original release version.
In sample below, note version differences in title field: Avatar, Avatar 3D, Avatar: An IMAX Experience. Also note runtime differences between versions.
Code[{ "tmsId": "MV004884770000", "rootId": "9991634", "subType": "Feature Film", "title": "Nebraska", "releaseYear": 2013, "releaseDate": "2013-05-22", "titleLang": "en", "descriptionLang": "en", "entityType": "Movie", "genres": ["Drama"], "longDescription": "Cantankerous old buzzard Woody Grant (Bruce Dern) can barely walk down the street of his home in Billings, Mont., without stopping for a drink. So when Woody receives receives a sweepstakes notice in the mail and insists on making a 750-mile trip to Lincoln, Neb., to collect his prize, it falls to baffled son David (Will Forte) to accompany him. During a stop in their Nebraska hometown, word gets out about Woody's fortune, first making him a hero, then later, the target of predatory people.", "shortDescription": "A man sets out on a road trip with his aging father to claim a cash prize that may not really exist.", "cast": [{ "billingOrder": "01", "role": "Actor", "nameId": "9564", "personId": "9564", "name": "Bruce Dern", "characterName": "Woody Grant" }, { "billingOrder": "02", "role": "Actor", "nameId": "294843", "personId": "291018", "name": "Will Forte", "characterName": "David Grant" }, { "billingOrder": "03", "role": "Actor", "nameId": "273287", "personId": "269698", "name": "June Squibb", "characterName": "Kate Grant" }, { "billingOrder": "04", "role": "Actor", "nameId": "195614", "personId": "193829", "name": "Bob Odenkirk", "characterName": "Ross Grant" }, { "billingOrder": "05", "role": "Actor", "nameId": "891", "personId": "891", "name": "Stacy Keach", "characterName": "Ed Pegram" }, { "billingOrder": "06", "role": "Actor", "nameId": "85497", "personId": "85497", "name": "Mary Louise Wilson", "characterName": "Aunt Martha" }, { "billingOrder": "07", "role": "Actor", "nameId": "71730", "personId": "71730", "name": "Rance Howard", "characterName": "Ray" }, { "billingOrder": "08", "role": "Actor", "nameId": "749522", "personId": "718856", "name": "Tim Driscoll", "characterName": "Bart" }, { "billingOrder": "09", "role": "Actor", "nameId": "16614", "personId": "16614", "name": "Devin Ratray", "characterName": "Cole" }, { "billingOrder": "10", "role": "Actor", "nameId": "690215", "personId": "663625", "name": "Angela McEwan", "characterName": "Peg" }, { "billingOrder": "11", "role": "Actor", "nameId": "866433", "personId": "826145", "name": "Elizabeth Moore", "characterName": "Aunt Flo" }, { "billingOrder": "12", "role": "Actor", "nameId": "757454", "personId": "725926", "name": "Kevin Kunkel", "characterName": "Cousin Randy" }, { "billingOrder": "13", "role": "Actor", "nameId": "792914", "personId": "757604", "name": "Dennis McCoig", "characterName": "Uncle Verne" }, { "billingOrder": "14", "role": "Actor", "nameId": "792916", "personId": "757606", "name": "Ronald Vosta", "characterName": "Uncle Albert" }], "crew": [{ "billingOrder": "01", "role": "Director", "nameId": "70201", "personId": "70201", "name": "Alexander Payne" }, { "billingOrder": "02", "role": "Screenwriter", "nameId": "866438", "personId": "826150", "name": "Bob Nelson" }, { "billingOrder": "03", "role": "Producer", "nameId": "749519", "personId": "718853", "name": "Albert Berga" }, { "billingOrder": "04", "role": "Producer", "nameId": "301026", "personId": "297110", "name": "Ron Yerxa" }, { "billingOrder": "05", "role": "Executive Producer", "nameId": "469444", "personId": "460569", "name": "George Parra" }, { "billingOrder": "06", "role": "Executive Producer", "nameId": "692321", "personId": "665568", "name": "Julie M. Thompson" }, { "billingOrder": "07", "role": "Executive Producer", "nameId": "298136", "personId": "294271", "name": "Doug Mankoff" }, { "billingOrder": "08", "role": "Executive Producer", "nameId": "529078", "personId": "513438", "name": "Neil Tabatznik" }, { "billingOrder": "09", "role": "Cinematographer", "nameId": "141115", "personId": "141115", "name": "Phedon Papamichael" }, { "billingOrder": "10", "role": "Film Editor", "nameId": "661249", "personId": "637668", "name": "Kevin Trent" }, { "billingOrder": "11", "role": "Original Music", "nameId": "471173", "personId": "462298", "name": "Mark Orton" }, { "billingOrder": "12", "role": "Production Design", "nameId": "501169", "personId": "481134", "name": "Dennis Washington" }, { "billingOrder": "13", "role": "Art Director", "nameId": "471081", "personId": "462206", "name": "Sandy Veneziano" }, { "billingOrder": "14", "role": "Set Decoration", "nameId": "866429", "personId": "457706", "name": "Fontaine Beauchamp" }, { "billingOrder": "15", "role": "Costume Designer", "nameId": "485298", "personId": "476423", "name": "Wendy Chuck" }, { "billingOrder": "16", "role": "Casting", "nameId": "389185", "personId": "380310", "name": "John Jackson" }], "directors": ["Alexander Payne"], "awards": [{ "awardId": "1", "name": "Academy Award", "awardName": "Academy Award", "year": "2013", "category": "Best Writing", "awardCatId": "21" }, { "awardId": "2", "name": "Golden Globe", "awardName": "Golden Globe", "year": "2013", "category": "Best Screenplay - Motion Picture", "awardCatId": "43" }, { "awardId": "2", "name": "Golden Globe", "awardName": "Golden Globe", "year": "2013", "category": "Best Motion Picture - Comedy or Musical", "awardCatId": "32" }, { "awardId": "1", "name": "Academy Award", "awardName": "Academy Award", "year": "2013", "category": "Best Picture", "awardCatId": "15" }, { "awardId": "6", "name": "British Academy of Film & Television Arts", "awardName": "British Academy of Film & Television Arts", "year": "2013", "category": "Cinematography", "awardCatId": "163" }, { "awardId": "1", "name": "Academy Award", "awardName": "Academy Award", "year": "2013", "category": "Best Cinematography", "awardCatId": "5" }, { "awardId": "1", "name": "Academy Award", "awardName": "Academy Award", "year": "2013", "category": "Best Directing", "awardCatId": "7" }, { "awardId": "3", "recipient": "June Squibb", "name": "Screen Actors Guild Awards", "awardName": "Screen Actors Guild Awards", "personId": "269698", "year": "2013", "category": "Outstanding Performance by a Female Actor in a Supporting Role", "awardCatId": "48" }, { "awardId": "2", "name": "Golden Globe", "awardName": "Golden Globe", "year": "2013", "category": "Best Performance By an Actress in a Supporting Role in a Motion Picture", "awardCatId": "257" }, { "awardId": "1", "name": "Academy Award", "awardName": "Academy Award", "year": "2013", "category": "Best Supporting Actress", "awardCatId": "19" }, { "awardId": "1", "name": "Academy Award", "awardName": "Academy Award", "year": "2013", "category": "Best Actor", "awardCatId": "1" }, { "awardId": "2", "name": "Golden Globe", "awardName": "Golden Globe", "year": "2013", "category": "Best Performance By an Actor in a Motion Picture - Comedy or Musical", "awardCatId": "256" }, { "awardId": "6", "name": "British Academy of Film & Television Arts", "awardName": "British Academy of Film & Television Arts", "year": "2013", "category": "Leading Actor", "awardCatId": "182" }, { "awardId": "2", "name": "Golden Globe", "awardName": "Golden Globe", "year": "2013", "category": "Best Director - Motion Picture", "awardCatId": "27" }, { "awardId": "3", "recipient": "Bruce Dern", "name": "Screen Actors Guild Awards", "awardName": "Screen Actors Guild Awards", "personId": "9564", "year": "2013", "category": "Outstanding Performance by a Male Actor in a Leading Role", "awardCatId": "45" }, { "awardId": "6", "name": "British Academy of Film & Television Arts", "awardName": "British Academy of Film & Television Arts", "year": "2013", "category": "Original Screenplay", "awardCatId": "195" }], "keywords": { "Mood": ["Brooding", "Profound", "Somber"], "Time Period": ["2010s"], "Theme": ["Discovery", "Fall", "Pursuit"], "Character": ["Old man", "Alcoholic", "Son", "Predator", "Friend", "Lottery winner"], "Setting": ["Montana", "Nebraska", "Bar", "House", "Office building", "Car"], "Subject": ["Money", "Trust", "Celebrity", "Alcoholism", "Friendship"] }, "officialUrl": "http://www.nebraskamovie.com/", "qualityRating": { "ratingsBody": "TMS", "value": "3.5" }, "ratings": [{ "body": "British Board of Film Classification", "code": "15" }, { "body": "Alberta's Film Classification Board", "code": "14A" }, { "body": "Motion Picture Association of America", "code": "R" }], "advisories": ["Adult Language", "Adult Situations"], "runTime": "PT01H54M", "preferredImage": { "width": "240", "height": "360", "caption": { "content": "Nebraska (2013)", "lang": "en" }, "uri": "assets/p9991634_p_v5_aa.jpg", "category": "Poster Art", "text": "yes", "primary": "true" } }, { "tmsId": "MV005978850000", "rootId": "9991634", "subType": "Feature Film", "title": "Nebraska", "releaseYear": 2013, "releaseDate": "2013", "titleLang": "en", "descriptionLang": "en", "entityType": "Movie", "genres": ["Drama"], "longDescription": "Cantankerous old buzzard Woody Grant (Bruce Dern) can barely walk down the street of his home in Billings, Mont., without stopping for a drink. So when Woody receives receives a sweepstakes notice in the mail and insists on making a 750-mile trip to Lincoln, Neb., to collect his prize, it falls to baffled son David (Will Forte) to accompany him. During a stop in their Nebraska hometown, word gets out about Woody's fortune, first making him a hero, then later, the target of predatory people.", "shortDescription": "A man sets out on a road trip with his aging father to claim a cash prize that may not really exist.", "cast": [{ "billingOrder": "01", "role": "Actor", "nameId": "9564", "personId": "9564", "name": "Bruce Dern", "characterName": "Woody Grant" }, { "billingOrder": "02", "role": "Actor", "nameId": "294843", "personId": "291018", "name": "Will Forte", "characterName": "David Grant" }, { "billingOrder": "03", "role": "Actor", "nameId": "273287", "personId": "269698", "name": "June Squibb", "characterName": "Kate Grant" }, { "billingOrder": "04", "role": "Actor", "nameId": "195614", "personId": "193829", "name": "Bob Odenkirk", "characterName": "Ross Grant" }, { "billingOrder": "05", "role": "Actor", "nameId": "891", "personId": "891", "name": "Stacy Keach", "characterName": "Ed Pegram" }, { "billingOrder": "06", "role": "Actor", "nameId": "85497", "personId": "85497", "name": "Mary Louise Wilson", "characterName": "Aunt Martha" }, { "billingOrder": "07", "role": "Actor", "nameId": "71730", "personId": "71730", "name": "Rance Howard", "characterName": "Ray" }, { "billingOrder": "08", "role": "Actor", "nameId": "749522", "personId": "718856", "name": "Tim Driscoll", "characterName": "Bart" }, { "billingOrder": "09", "role": "Actor", "nameId": "16614", "personId": "16614", "name": "Devin Ratray", "characterName": "Cole" }, { "billingOrder": "10", "role": "Actor", "nameId": "690215", "personId": "663625", "name": "Angela McEwan", "characterName": "Peg" }, { "billingOrder": "11", "role": "Actor", "nameId": "866433", "personId": "826145", "name": "Elizabeth Moore", "characterName": "Aunt Flo" }, { "billingOrder": "12", "role": "Actor", "nameId": "757454", "personId": "725926", "name": "Kevin Kunkel", "characterName": "Cousin Randy" }, { "billingOrder": "13", "role": "Actor", "nameId": "792914", "personId": "757604", "name": "Dennis McCoig", "characterName": "Uncle Verne" }, { "billingOrder": "14", "role": "Actor", "nameId": "792916", "personId": "757606", "name": "Ronald Vosta", "characterName": "Uncle Albert" }], "crew": [{ "billingOrder": "01", "role": "Director", "nameId": "70201", "personId": "70201", "name": "Alexander Payne" }, { "billingOrder": "02", "role": "Screenwriter", "nameId": "866438", "personId": "826150", "name": "Bob Nelson" }, { "billingOrder": "03", "role": "Producer", "nameId": "749519", "personId": "718853", "name": "Albert Berga" }, { "billingOrder": "04", "role": "Producer", "nameId": "301026", "personId": "297110", "name": "Ron Yerxa" }, { "billingOrder": "05", "role": "Executive Producer", "nameId": "469444", "personId": "460569", "name": "George Parra" }, { "billingOrder": "06", "role": "Executive Producer", "nameId": "692321", "personId": "665568", "name": "Julie M. Thompson" }, { "billingOrder": "07", "role": "Executive Producer", "nameId": "298136", "personId": "294271", "name": "Doug Mankoff" }, { "billingOrder": "08", "role": "Executive Producer", "nameId": "529078", "personId": "513438", "name": "Neil Tabatznik" }, { "billingOrder": "09", "role": "Cinematographer", "nameId": "141115", "personId": "141115", "name": "Phedon Papamichael" }, { "billingOrder": "10", "role": "Film Editor", "nameId": "661249", "personId": "637668", "name": "Kevin Trent" }, { "billingOrder": "11", "role": "Original Music", "nameId": "471173", "personId": "462298", "name": "Mark Orton" }, { "billingOrder": "12", "role": "Production Design", "nameId": "501169", "personId": "481134", "name": "Dennis Washington" }, { "billingOrder": "13", "role": "Art Director", "nameId": "471081", "personId": "462206", "name": "Sandy Veneziano" }, { "billingOrder": "14", "role": "Set Decoration", "nameId": "866429", "personId": "457706", "name": "Fontaine Beauchamp" }, { "billingOrder": "15", "role": "Costume Designer", "nameId": "485298", "personId": "476423", "name": "Wendy Chuck" }, { "billingOrder": "16", "role": "Casting", "nameId": "389185", "personId": "380310", "name": "John Jackson" }], "directors": ["Alexander Payne"], "awards": [{ "awardId": "2", "recipient": "Bruce Dern", "name": "Golden Globe", "awardName": "Golden Globe", "personId": "9564", "year": "2013", "category": "Best Performance By an Actor in a Motion Picture - Comedy or Musical", "awardCatId": "256" }, { "awardId": "3", "recipient": "June Squibb", "name": "Screen Actors Guild Awards", "awardName": "Screen Actors Guild Awards", "personId": "269698", "year": "2013", "category": "Outstanding Performance by a Female Actor in a Supporting Role", "awardCatId": "48" }, { "awardId": "2", "recipient": "June Squibb", "name": "Golden Globe", "awardName": "Golden Globe", "personId": "269698", "year": "2013", "category": "Best Performance By an Actress in a Supporting Role in a Motion Picture", "awardCatId": "257" }, { "awardId": "1", "recipient": "June Squibb", "name": "Academy Award", "awardName": "Academy Award", "personId": "269698", "year": "2013", "category": "Best Supporting Actress", "awardCatId": "19" }, { "awardId": "1", "recipient": "Bruce Dern", "name": "Academy Award", "awardName": "Academy Award", "personId": "9564", "year": "2013", "category": "Best Actor", "awardCatId": "1" }, { "awardId": "3", "recipient": "Bruce Dern", "name": "Screen Actors Guild Awards", "awardName": "Screen Actors Guild Awards", "personId": "9564", "year": "2013", "category": "Outstanding Performance by a Male Actor in a Leading Role", "awardCatId": "45" }, { "awardId": "1", "name": "Academy Award", "awardName": "Academy Award", "year": "2013", "category": "Best Picture", "awardCatId": "15" }, { "awardId": "1", "name": "Academy Award", "awardName": "Academy Award", "year": "2013", "category": "Best Writing", "awardCatId": "21" }, { "awardId": "2", "name": "Golden Globe", "awardName": "Golden Globe", "year": "2013", "category": "Best Motion Picture - Comedy or Musical", "awardCatId": "32" }, { "awardId": "6", "name": "British Academy of Film & Television Arts", "awardName": "British Academy of Film & Television Arts", "year": "2013", "category": "Cinematography", "awardCatId": "163" }, { "awardId": "2", "name": "Golden Globe", "awardName": "Golden Globe", "year": "2013", "category": "Best Director - Motion Picture", "awardCatId": "27" }, { "awardId": "1", "name": "Academy Award", "awardName": "Academy Award", "year": "2013", "category": "Best Cinematography", "awardCatId": "5" }, { "awardId": "6", "name": "British Academy of Film & Television Arts", "awardName": "British Academy of Film & Television Arts", "year": "2013", "category": "Original Screenplay", "awardCatId": "195" }, { "awardId": "1", "name": "Academy Award", "awardName": "Academy Award", "year": "2013", "category": "Best Directing", "awardCatId": "7" }, { "awardId": "2", "name": "Golden Globe", "awardName": "Golden Globe", "year": "2013", "category": "Best Screenplay - Motion Picture", "awardCatId": "43" }, { "awardId": "6", "recipient": "Bruce Dern", "name": "British Academy of Film & Television Arts", "awardName": "British Academy of Film & Television Arts", "personId": "9564", "year": "2013", "category": "Leading Actor", "awardCatId": "182" }], "keywords": { "Mood": ["Brooding", "Profound", "Somber"], "Time Period": ["2010s"], "Theme": ["Discovery", "Fall", "Pursuit"], "Character": ["Old man", "Alcoholic", "Son", "Predator", "Friend", "Lottery winner"], "Setting": ["Montana", "Nebraska", "Bar", "House", "Office building", "Car"], "Subject": ["Money", "Trust", "Celebrity", "Alcoholism", "Friendship"] }, "officialUrl": "http://www.nebraskamovie.com/", "qualityRating": { "ratingsBody": "TMS", "value": "3.5" }, "ratings": [{ "body": "British Board of Film Classification", "code": "15" }, { "body": "Motion Picture Association of America", "code": "R" }], "advisories": ["Adult Language", "Adult Situations"], "runTime": "PT01H54M", "preferredImage": { "width": "240", "height": "360", "caption": { "content": "Nebraska (2013)", "lang": "en" }, "uri": "assets/p9991634_p_v5_aa.jpg", "category": "Poster Art", "text": "yes", "primary": "true" } }]
Last modified on