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.

• Movie Lists

  • List Methods
  • Expand Methods

  • GETBox Office/api/public/v1.0/lists/movies/box_office.jsonDisplays top box office earning movies, sorted by most recent weekend gross ticket sales.
    Parameter	Value	Type	Description
    limit		string	Limits the number of movies returned
    country		string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

  • GETIn Theaters/api/public/v1.0/lists/movies/in_theaters.jsonRetrieves movies currently in theaters
    Parameter	Value	Type	Description
    page_limit		string	The amount of movies in theaters to show per page
    page		string	The selected page of in theaters movies
    country		string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

  • GETOpening Movies/api/public/v1.0/lists/movies/opening.jsonRetrieves current opening movies
    Parameter	Value	Type	Description
    limit		string	Limits the number of opening movies returned
    country		string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

  • GETUpcoming Movies/api/public/v1.0/lists/movies/upcoming.jsonRetrieves upcoming movies. Results are paginated if they go past the specified page limit
    Parameter	Value	Type	Description
    page_limit		string	The amount of upcoming movies to show per page
    page		string	The selected page of upcoming movies
    country		string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

• DVD Lists

  • List Methods
  • Expand Methods

  • GETTop Rentals/api/public/v1.0/lists/dvds/top_rentals.jsonRetrieves the current top dvd rentals
    Parameter	Value	Type	Description
    limit		string	Limits the number of top rentals returned
    country		string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

  • 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
    Parameter	Value	Type	Description
    page_limit		string	The amount of new release dvds to show per page
    page		string	The selected page of current DVD releases
    country		string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

  • 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
    Parameter	Value	Type	Description
    page_limit		string	The amount of new release dvds to show per page
    page		string	The selected page of new release DVDs
    country		string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

  • GETUpcoming DVDs/api/public/v1.0/lists/dvds/upcoming.jsonRetrieves new release dvds. Results are paginated if they go past the specified page limit
    Parameter	Value	Type	Description
    page_limit		string	The amount of upcoming dvds to show per page
    page		string	The selected page of upcoming DVDs
    country		string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

• Detailed Info

  • List Methods
  • Expand Methods

  • 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.
    Parameter	Value	Type	Description
    id		string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID

  • GETCast Info/api/public/v1.0/movies/:id/cast.jsonPulls the complete movie cast for a movie
    Parameter	Value	Type	Description
    id		string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID

  • GETMovie Clips/api/public/v1.0/movies/:id/clips.jsonRelated movie clips and trailers for a movie
    Parameter	Value	Type	Description
    id		string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID

  • 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
    Parameter	Value	Type	Description
    id		string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID
    review_type		string	3 different review types are possible: 'all', 'top_critic' and 'dvd'. 'top_critic' shows all the Rotten Tomatoes designated top critics. 'dvd' pulls the reviews given on the DVD of the movie. 'all' as the name implies retrieves all reviews.
    page_limit		string	The number of reviews to show per page
    page		string	The selected page of reviews
    country		string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

  • GETMovies Similar/api/public/v1.0/movies/:id/similar.jsonShows similar movies for a movie.
    Parameter	Value	Type	Description
    id		string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID
    limit		string	Limit the number of similar movies to show

  • 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
    Parameter	Value	Type	Description
    id		string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID
    type		string	Only supports imdb lookup at this time

• Search

  • List Methods
  • Expand Methods

  • GETMovies Search/api/public/v1.0/movies.jsonThe movies search endpoint for plain text queries. Let's you search for movies!
    Parameter	Value	Type	Description
    q		string	The plain text search query to search for a movie. Remember to URI encode this!
    page_limit		string	The amount of movie search results to show per page
    page		string	The selected page of movie search results

• Top Level Lists

  • List Methods
  • Expand Methods

  • 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