Rotten Tomatoes
Interact with the Rotten Tomatoes API. Discover, test, debug live calls within our documentation. See the Documentation Overview for an API Quick Dive and more.
API Credentials
GETBox Office/api/public/v1.0/lists/movies/box_office.jsonDisplays top box office earning movies, sorted by most recent weekend gross ticket sales.
GETIn Theaters/api/public/v1.0/lists/movies/in_theaters.jsonRetrieves movies currently in theaters
GETOpening Movies/api/public/v1.0/lists/movies/opening.jsonRetrieves current opening movies
GETUpcoming Movies/api/public/v1.0/lists/movies/upcoming.jsonRetrieves upcoming movies. Results are paginated if they go past the specified page limit
GETTop Rentals/api/public/v1.0/lists/dvds/top_rentals.jsonRetrieves the current top dvd rentals
GETCurrent Release DVDs/api/public/v1.0/lists/dvds/current_releases.jsonRetrieves current release dvds. Results are paginated if they go past the specified page limit
GETNew Release DVDs/api/public/v1.0/lists/dvds/new_releases.jsonRetrieves new release dvds. Results are paginated if they go past the specified page limit
GETUpcoming DVDs/api/public/v1.0/lists/dvds/upcoming.jsonRetrieves new release dvds. Results are paginated if they go past the specified page limit
GETMovies Info/api/public/v1.0/movies/:id.jsonDetailed information on a specific movie specified by Id. You can use the movies search endpoint or peruse the lists of movies/dvds to get the urls to movies.
GETCast Info/api/public/v1.0/movies/:id/cast.jsonPulls the complete movie cast for a movie
GETMovie Clips/api/public/v1.0/movies/:id/clips.jsonRelated movie clips and trailers for a movie
GETMovies Reviews/api/public/v1.0/movies/:id/reviews.jsonRetrieves the reviews for a movie. Results are paginated if they go past the specified page limit
GETMovies Similar/api/public/v1.0/movies/:id/similar.jsonShows similar movies for a movie.
GETMovies Alias/api/public/v1.0/movie_alias.jsonProvides a movie lookup by an id from a different vendor. Only supports imdb lookup at this time
GETLists Directory/api/public/v1.0/lists.jsonDisplays the top level lists available in the API. We currently have movie lists and dvd lists available
GETMovie Lists Directory/api/public/v1.0/lists/movies.jsonShows the movie lists we have available
GETDVD Lists Directory/api/public/v1.0/lists/dvds.jsonShows the movie lists we have available