- Previous: Movie Similar
- Up: API Homepage - v1.0.json
- Next: Example Code
Movie Alias
Provides a movie lookup by an id from a different vendor. Only supports imdb lookup at this time
WARNING - This feature is Beta quality. Accuracy of the lookup is not promised
If you see inaccuracies, please report them in the forums
URL
http://api.rottentomatoes.com/api/public/v1.0/movie_alias.json?apikey=[your_api_key]
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
| type | false | alias type you want to look up - only imdb is supported at this time | |
| id | false | The id you want to look up |
Example Call and Response
http://api.rottentomatoes.com/api/public/v1.0/movie_alias.json?apikey=[your_api_key]&type=imdb&id=0031381
{
"id": 9818,
"title": "Gone With the Wind",
"year": 1939,
"genres": [
"Drama",
"Romance",
"Classics"
],
"mpaa_rating": "G",
"runtime": 222,
"critics_consensus": "Filmed and presented on a scale not seen in modern productions, Gone with the Wind is, if not the definitive Hollywood film, then certainly near the top of the list.",
"release_dates": {
"theater": "1939-12-15",
"dvd": "2000-03-07"
},
"ratings": {
"critics_rating": "Certified Fresh",
"critics_score": 95,
"audience_rating": "Upright",
"audience_score": 91
},
"synopsis": "",
"posters": {
"thumbnail": "http://content9.flixster.com/movie/10/93/18/10931807_mob.jpg",
"profile": "http://content9.flixster.com/movie/10/93/18/10931807_pro.jpg",
"detailed": "http://content9.flixster.com/movie/10/93/18/10931807_det.jpg",
"original": "http://content9.flixster.com/movie/10/93/18/10931807_ori.jpg"
},
"abridged_cast": [
{
"name": "Clark Gable",
"characters": ["Rhett Butler"]
},
{
"name": "Vivien Leigh",
"characters": ["Scarlett O'Hara"]
},
{
"name": "Leslie Howard",
"characters": ["Ashley Wilkes"]
},
{
"name": "Olivia de Havilland",
"characters": ["Melanie Hamilton"]
},
{
"name": "Hattie McDaniel",
"characters": ["Mammy"]
}
],
"abridged_directors": [
{"name": "George Cukor"},
{"name": "Sam Wood"}
],
"studio": "New Line Cinema",
"alternate_ids": {"imdb": "0031381"},
"links": {
"self": "http://api.rottentomatoes.com/api/public/v1.0/movie_alias.json?type=imdb&id=0031381",
"alternate": "http://www.rottentomatoes.com/m/gone_with_the_wind/",
"cast": "http://api.rottentomatoes.com/api/public/v1.0/movies/9818/cast.json",
"clips": "http://api.rottentomatoes.com/api/public/v1.0/movies/9818/clips.json",
"reviews": "http://api.rottentomatoes.com/api/public/v1.0/movies/9818/reviews.json",
"similar": "http://api.rottentomatoes.com/api/public/v1.0/movies/9818/similar.json",
"canonical": "http://api.rottentomatoes.com/api/public/v1.0/movies/9818.json"
},
"link_template": "http://api.rottentomatoes.com/api/public/v1.0/movie_alias.json?type=imdb&id={alias-id}"
}
- Previous: Movie Similar
- Up: API Homepage - v1.0.json
- Next: Example Code
2 Comments
Crayola – 1 month ago
I cannot get this to work. I keep receiving '{"error":"Account Over Rate Limit"}' even though I hardly made any queries today, and though other API queries work perfectly.
Crayola – 1 month ago
Embarrassing. I was sending parameter 'api_key' instead of 'apikey'..
Please sign in to post a comment.