Movie versions
/movies/:rootId/versions
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. See Image Sizing for details. |
|
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=1234567890Sample 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.
[{
"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"
}
}]