Rotten Tomatoes

Movie and TV review aggregator API

developer.fandango.com/rotten_tomatoes ↗

Version

1.0

OpenAPI

3.0.0

Endpoints

Schemas

Updated

3 days ago

Entertainment entertainment movies reviews

Use this API in your AI agent

Query structured spec data via REST or MCP. Get exactly what your agent needs.

Get API Key

Server URLs

http://api.rottentomatoes.com/api/public/v1.0

Authentication

apiKey

Endpoints

Clear filters

GET POST PUT PATCH DELETE

Dvd lists 4 endpoints

GET /lists/dvds/current_releases.json

operationId: DvdLists_getCurrentReleases

Parameters

Name	In	Required	Type	Description
page_limit	query	optional	string	The amount of new release dvds to show per page
page	query	optional	string	The selected page of current DVD releases
country	query	optional	string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists/dvds/current_releases.json

GET /lists/dvds/new_releases.json

operationId: DvdLists_getNewReleasesJson

Parameters

Name	In	Required	Type	Description
page_limit	query	optional	string	The amount of new release dvds to show per page
page	query	optional	string	The selected page of new release DVDs
country	query	optional	string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists/dvds/new_releases.json

GET /lists/dvds/top_rentals.json

operationId: DvdLists_getTopRentalsJson

Parameters

Name	In	Required	Type	Description
limit	query	optional	string	Limits the number of top rentals returned
country	query	optional	string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists/dvds/top_rentals.json

GET /lists/dvds/upcoming.json

operationId: DvdLists_getUpcomingDvds

Parameters

Name	In	Required	Type	Description
page_limit	query	optional	string	The amount of upcoming dvds to show per page
page	query	optional	string	The selected page of upcoming DVDs
country	query	optional	string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists/dvds/upcoming.json

Detailed info 6 endpoints

GET /movie_alias.json

operationId: DetailedInfo_getMovieAliasInfo

Parameters

Name	In	Required	Type	Description
id	query	optional	string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID
type	query	optional	string	Only supports imdb lookup at this time

Responses

200 Success

400 Bad Request

403 Forbidden

GET /movie_alias.json

GET /movies/{id}.json

operationId: DetailedInfo_getMovieByIdJson

Parameters

Name	In	Required	Type	Description
id	path	required	string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID

Responses

200 Success

400 Bad Request

403 Forbidden

GET /movies/{id}.json

GET /movies/{id}/cast.json

operationId: DetailedInfo_getMovieCast

Parameters

Name	In	Required	Type	Description
id	path	required	string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID

Responses

200 Success

400 Bad Request

403 Forbidden

GET /movies/{id}/cast.json

GET /movies/{id}/clips.json

operationId: DetailedInfo_getClipById

Parameters

Name	In	Required	Type	Description
id	path	required	string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID

Responses

200 Success

400 Bad Request

403 Forbidden

GET /movies/{id}/clips.json

GET /movies/{id}/reviews.json

operationId: DetailedInfo_getMovieReviews

Parameters

Name	In	Required	Type	Description
id	path	required	string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID
review_type	query	optional	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	query	optional	string	The number of reviews to show per page
page	query	optional	string	The selected page of reviews
country	query	optional	string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

Responses

200 Success

400 Bad Request

403 Forbidden

GET /movies/{id}/reviews.json

GET /movies/{id}/similar.json

operationId: DetailedInfo_findSimilarMovies

Parameters

Name	In	Required	Type	Description
id	path	required	string	Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID
limit	query	optional	string	Limit the number of similar movies to show

Responses

200 Success

400 Bad Request

403 Forbidden

GET /movies/{id}/similar.json

Movie lists 4 endpoints

GET /lists/movies/box_office.json

operationId: MovieLists_getBoxOfficeJson

Parameters

Name	In	Required	Type	Description
limit	query	optional	string	Limits the number of movies returned
country	query	optional	string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists/movies/box_office.json

GET /lists/movies/in_theaters.json

operationId: MovieLists_getIntheaterMovies

Parameters

Name	In	Required	Type	Description
page_limit	query	optional	string	The amount of movies in theaters to show per page
page	query	optional	string	The selected page of in theaters movies
country	query	optional	string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists/movies/in_theaters.json

GET /lists/movies/opening.json

operationId: MovieLists_getOpeningMovies

Parameters

Name	In	Required	Type	Description
limit	query	optional	string	Limits the number of opening movies returned
country	query	optional	string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists/movies/opening.json

GET /lists/movies/upcoming.json

operationId: MovieLists_getUpcomingMovies

Parameters

Name	In	Required	Type	Description
page_limit	query	optional	string	The amount of upcoming movies to show per page
page	query	optional	string	The selected page of upcoming movies
country	query	optional	string	Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists/movies/upcoming.json

Search 1 endpoints

GET /movies.json

operationId: Search_moviesJson

Parameters

Name	In	Required	Type	Description
q	query	optional	string	The plain text search query to search for a movie. Remember to URI encode this!
page_limit	query	optional	string	The amount of movie search results to show per page
page	query	optional	string	The selected page of movie search results

Responses

200 Success

400 Bad Request

403 Forbidden

GET /movies.json

Top level lists 3 endpoints

GET /lists.json

operationId: TopLevelLists_getData

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists.json

GET /lists/dvds.json

operationId: TopLevelLists_getDvds

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists/dvds.json

GET /lists/movies.json

operationId: TopLevelLists_getMoviesJson

Responses

200 Success

400 Bad Request

403 Forbidden

GET /lists/movies.json