Docs menu

Rotten Tomatoes API endpoint

Rotten Tomatoes movie detail API

Returns Rotten Tomatoes movie metadata, scorecard data, and representative audience reviews. Pass exactly one of `path` or `url`.

GETapiKey3 credits/requestRotten Tomatoesrottentomatoes.movieResponseDoc/rottentomatoes/movie

Endpoint facts

Method: GET
API path: /rottentomatoes/movie
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Rotten Tomatoes
Response schema: #/definitions/rottentomatoes.movieResponseDoc

Rotten Tomatoes Scraper API Try Rotten Tomatoes movie detail API in Playground Rotten Tomatoes API documentation

How this endpoint behaves

Returns Rotten Tomatoes movie metadata, scorecard data, and a small set of representative audience reviews.

Query parameters:

path: Rotten Tomatoes movie path, for example /m/inception.
url: absolute https://www.rottentomatoes.com movie URL.

Notable response behavior:

data.public_page_derived is true.
critics_score and audience_score are included only when the public page exposes scorecard data.
Upstream challenge pages, malformed page data, or parser drift are returned as typed upstream errors.

Live monitoring

Monitored request: GET /rottentomatoes/movie?path=%2Fm%2Finception
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.67 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/movie?path=%2Fm%2Finception
Items in audience_reviews: 6
Fields filled in every checked item: 8

Field	Filled in, of 6 checked	Values in the sample
display_name	6
display_date	6	“Mar 19, 2026” and 3 other values
rating	6	5
rating_range	6	Rated 5/5 Stars in all 6
rating_id	6
review	6	“Watching this movie with the beautiful Rena!” and 5 other values
verified	6	true in 6 of 6
fandango_review	6	true in 6 of 6

Request parameters

Parameter	Type	Required	Description	Example
path	string	No	Rotten Tomatoes movie path	/m/inception
url	string	No	Absolute https://www.rottentomatoes.com movie URL	https://www.rottentomatoes.com/m/inception
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/movie" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Inception",
    "path": "/m/inception",
    "url": "https://www.rottentomatoes.com/m/inception",
    "media_type": "Movie",
    "critics_score": {
      "score_percent": "87%"
    },
    "audience_score": {
      "score_percent": "91%"
    },
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.movieResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	rottentomatoes.MovieResponse	No
data.audience_reviews	array	No		Sample of audience reviews shown on the movie page.
data.audience_reviews[].display_date	string	No	Mar 19	Date the review was posted, as shown on the page, such as `Mar 19`.
data.audience_reviews[].display_name	string	No	Rylee	Display name of the reviewer.
data.audience_reviews[].fandango_review	boolean	No	true	Whether Rotten Tomatoes flags the review as a Fandango review.
data.audience_reviews[].rating	number	No	5	Star rating the reviewer gave, such as `5`.
data.audience_reviews[].rating_id	string	No	e0812d98-c1d5-467d-ae35-c19cdd575f90	Unique id of the rating.
data.audience_reviews[].rating_range	string	No	Rated 5/5 Stars	Rating text as shown on the page, such as `Rated 5/5 Stars`.
data.audience_reviews[].review	string	No		Text of the review.
data.audience_reviews[].verified	boolean	No	true	Whether the review is marked as verified.
data.audience_score	object	No		Popcornmeter audience score of the movie.
data.audience_score.average_rating	string	No	8.40	Average rating as shown on the scorecard, such as `8.40`.
data.audience_score.banded_rating_count	string	No	250,000+ Ratings	Approximate number of ratings as shown on the page, such as `250,000+ Ratings`.
data.audience_score.certified	boolean	No	true	Whether Rotten Tomatoes marks the score as certified.
data.audience_score.liked_count	integer	No	314	Number of ratings that liked the title.
data.audience_score.not_liked_count	integer	No	49	Number of ratings that did not like the title.
data.audience_score.rating_count	integer	No	363	Number of ratings behind the score.
data.audience_score.review_count	integer	No	363	Number of reviews behind the score.
data.audience_score.reviews_page_url	string	No	https://www.rottentomatoes.com/m/inception/reviews	URL of the Rotten Tomatoes page that lists the reviews behind this score.
data.audience_score.score	integer	No	87	Score as a whole-number percentage.
data.audience_score.score_percent	string	No	87%	Score as text with a percent sign, such as `87%`.
data.audience_score.score_type	string	No	ALL	Audience group the score covers, such as `ALL` or `VERIFIED`.
data.audience_score.sentiment	string	No	POSITIVE	Overall sentiment of the score, such as `POSITIVE`.
data.audience_score.title	string	No	Tomatometer	Name of the score, such as `Tomatometer` or `Popcornmeter`.
data.cast	array	No		People in the cast of the movie.
data.cast[].image_url	string	No		URL of the person's photo.
data.cast[].name	string	No	Christopher Nolan	Name of the person.
data.cast[].url	string	No	https://www.rottentomatoes.com/celebrity/christopher_nolan	Rotten Tomatoes page URL of the person.
data.content_rating	string	No	PG-13	Content rating of the movie, such as `PG-13`.
data.critics_score	object	No		Tomatometer critics score of the movie.
data.critics_score.average_rating	string	No	8.40	Average rating as shown on the scorecard, such as `8.40`.
data.critics_score.banded_rating_count	string	No	250,000+ Ratings	Approximate number of ratings as shown on the page, such as `250,000+ Ratings`.
data.critics_score.certified	boolean	No	true	Whether Rotten Tomatoes marks the score as certified.
data.critics_score.liked_count	integer	No	314	Number of ratings that liked the title.
data.critics_score.not_liked_count	integer	No	49	Number of ratings that did not like the title.
data.critics_score.rating_count	integer	No	363	Number of ratings behind the score.
data.critics_score.review_count	integer	No	363	Number of reviews behind the score.
data.critics_score.reviews_page_url	string	No	https://www.rottentomatoes.com/m/inception/reviews	URL of the Rotten Tomatoes page that lists the reviews behind this score.
data.critics_score.score	integer	No	87	Score as a whole-number percentage.
data.critics_score.score_percent	string	No	87%	Score as text with a percent sign, such as `87%`.
data.critics_score.score_type	string	No	ALL	Audience group the score covers, such as `ALL` or `VERIFIED`.
data.critics_score.sentiment	string	No	POSITIVE	Overall sentiment of the score, such as `POSITIVE`.
data.critics_score.title	string	No	Tomatometer	Name of the score, such as `Tomatometer` or `Popcornmeter`.
data.description	string	No		Short synopsis of the movie.
data.directors	array	No		Directors of the movie.
data.directors[].image_url	string	No		URL of the person's photo.
data.directors[].name	string	No	Christopher Nolan	Name of the person.
data.directors[].url	string	No	https://www.rottentomatoes.com/celebrity/christopher_nolan	Rotten Tomatoes page URL of the person.
data.ems_id	string	No	afbf1c81-1bfe-3996-9cbc-2e1be23d1f61	Rotten Tomatoes' own unique id of the movie.
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.genres	array	No	Sci-Fi	Genres of the movie.
data.image_url	string	No		URL of the poster image.
data.media_type	string	No	Movie	Kind of title, such as `Movie`.
data.path	string	No	/m/inception	Rotten Tomatoes path of the movie page, such as `/m/inception`.
data.producers	array	No		Producers of the movie.
data.producers[].image_url	string	No		URL of the person's photo.
data.producers[].name	string	No	Christopher Nolan	Name of the person.
data.producers[].url	string	No	https://www.rottentomatoes.com/celebrity/christopher_nolan	Rotten Tomatoes page URL of the person.
data.public_page_derived	boolean	No	true	Always `true`: the data comes from publicly visible Rotten Tomatoes pages.
data.release_date	string	No	2010-07-16	Release date of the movie, such as `2010-07-16`.
data.reviews_url	string	No	https://www.rottentomatoes.com/m/inception/reviews/all-audience	URL of the Rotten Tomatoes page with the audience reviews of the movie.
data.source_url	string	No	https://www.rottentomatoes.com/m/inception	URL the data was read from.
data.title	string	No	Inception	Title of the movie, as Rotten Tomatoes shows it.
data.url	string	No	https://www.rottentomatoes.com/m/inception	Rotten Tomatoes page URL of the movie.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/movie" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Rotten Tomatoes endpoint docs Rotten Tomatoes Scraper API Rotten Tomatoes browse filters API documentation Rotten Tomatoes movie discovery rows API documentation Rotten Tomatoes TV discovery rows API documentation Rotten Tomatoes Critics Directory API documentation Rotten Tomatoes Editorial Content API documentation Rotten Tomatoes Editorial Detail API documentation

Open in Playground Back to group

Docs menu

Rotten Tomatoes API endpoint

Rotten Tomatoes movie detail API

Returns Rotten Tomatoes movie metadata, scorecard data, and representative audience reviews. Pass exactly one of `path` or `url`.

GETapiKey3 credits/requestRotten Tomatoesrottentomatoes.movieResponseDoc/rottentomatoes/movie

Endpoint facts

Method: GET
API path: /rottentomatoes/movie
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Rotten Tomatoes
Response schema: #/definitions/rottentomatoes.movieResponseDoc

Rotten Tomatoes Scraper API Try Rotten Tomatoes movie detail API in Playground Rotten Tomatoes API documentation

How this endpoint behaves

Returns Rotten Tomatoes movie metadata, scorecard data, and a small set of representative audience reviews.

Query parameters:

path: Rotten Tomatoes movie path, for example /m/inception.
url: absolute https://www.rottentomatoes.com movie URL.

Notable response behavior:

data.public_page_derived is true.
critics_score and audience_score are included only when the public page exposes scorecard data.
Upstream challenge pages, malformed page data, or parser drift are returned as typed upstream errors.

Live monitoring

Monitored request: GET /rottentomatoes/movie?path=%2Fm%2Finception
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.67 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/movie?path=%2Fm%2Finception
Items in audience_reviews: 6
Fields filled in every checked item: 8

Field	Filled in, of 6 checked	Values in the sample
display_name	6
display_date	6	“Mar 19, 2026” and 3 other values
rating	6	5
rating_range	6	Rated 5/5 Stars in all 6
rating_id	6
review	6	“Watching this movie with the beautiful Rena!” and 5 other values
verified	6	true in 6 of 6
fandango_review	6	true in 6 of 6

Request parameters

Parameter	Type	Required	Description	Example
path	string	No	Rotten Tomatoes movie path	/m/inception
url	string	No	Absolute https://www.rottentomatoes.com movie URL	https://www.rottentomatoes.com/m/inception
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/movie" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Inception",
    "path": "/m/inception",
    "url": "https://www.rottentomatoes.com/m/inception",
    "media_type": "Movie",
    "critics_score": {
      "score_percent": "87%"
    },
    "audience_score": {
      "score_percent": "91%"
    },
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.movieResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	rottentomatoes.MovieResponse	No
data.audience_reviews	array	No		Sample of audience reviews shown on the movie page.
data.audience_reviews[].display_date	string	No	Mar 19	Date the review was posted, as shown on the page, such as `Mar 19`.
data.audience_reviews[].display_name	string	No	Rylee	Display name of the reviewer.
data.audience_reviews[].fandango_review	boolean	No	true	Whether Rotten Tomatoes flags the review as a Fandango review.
data.audience_reviews[].rating	number	No	5	Star rating the reviewer gave, such as `5`.
data.audience_reviews[].rating_id	string	No	e0812d98-c1d5-467d-ae35-c19cdd575f90	Unique id of the rating.
data.audience_reviews[].rating_range	string	No	Rated 5/5 Stars	Rating text as shown on the page, such as `Rated 5/5 Stars`.
data.audience_reviews[].review	string	No		Text of the review.
data.audience_reviews[].verified	boolean	No	true	Whether the review is marked as verified.
data.audience_score	object	No		Popcornmeter audience score of the movie.
data.audience_score.average_rating	string	No	8.40	Average rating as shown on the scorecard, such as `8.40`.
data.audience_score.banded_rating_count	string	No	250,000+ Ratings	Approximate number of ratings as shown on the page, such as `250,000+ Ratings`.
data.audience_score.certified	boolean	No	true	Whether Rotten Tomatoes marks the score as certified.
data.audience_score.liked_count	integer	No	314	Number of ratings that liked the title.
data.audience_score.not_liked_count	integer	No	49	Number of ratings that did not like the title.
data.audience_score.rating_count	integer	No	363	Number of ratings behind the score.
data.audience_score.review_count	integer	No	363	Number of reviews behind the score.
data.audience_score.reviews_page_url	string	No	https://www.rottentomatoes.com/m/inception/reviews	URL of the Rotten Tomatoes page that lists the reviews behind this score.
data.audience_score.score	integer	No	87	Score as a whole-number percentage.
data.audience_score.score_percent	string	No	87%	Score as text with a percent sign, such as `87%`.
data.audience_score.score_type	string	No	ALL	Audience group the score covers, such as `ALL` or `VERIFIED`.
data.audience_score.sentiment	string	No	POSITIVE	Overall sentiment of the score, such as `POSITIVE`.
data.audience_score.title	string	No	Tomatometer	Name of the score, such as `Tomatometer` or `Popcornmeter`.
data.cast	array	No		People in the cast of the movie.
data.cast[].image_url	string	No		URL of the person's photo.
data.cast[].name	string	No	Christopher Nolan	Name of the person.
data.cast[].url	string	No	https://www.rottentomatoes.com/celebrity/christopher_nolan	Rotten Tomatoes page URL of the person.
data.content_rating	string	No	PG-13	Content rating of the movie, such as `PG-13`.
data.critics_score	object	No		Tomatometer critics score of the movie.
data.critics_score.average_rating	string	No	8.40	Average rating as shown on the scorecard, such as `8.40`.
data.critics_score.banded_rating_count	string	No	250,000+ Ratings	Approximate number of ratings as shown on the page, such as `250,000+ Ratings`.
data.critics_score.certified	boolean	No	true	Whether Rotten Tomatoes marks the score as certified.
data.critics_score.liked_count	integer	No	314	Number of ratings that liked the title.
data.critics_score.not_liked_count	integer	No	49	Number of ratings that did not like the title.
data.critics_score.rating_count	integer	No	363	Number of ratings behind the score.
data.critics_score.review_count	integer	No	363	Number of reviews behind the score.
data.critics_score.reviews_page_url	string	No	https://www.rottentomatoes.com/m/inception/reviews	URL of the Rotten Tomatoes page that lists the reviews behind this score.
data.critics_score.score	integer	No	87	Score as a whole-number percentage.
data.critics_score.score_percent	string	No	87%	Score as text with a percent sign, such as `87%`.
data.critics_score.score_type	string	No	ALL	Audience group the score covers, such as `ALL` or `VERIFIED`.
data.critics_score.sentiment	string	No	POSITIVE	Overall sentiment of the score, such as `POSITIVE`.
data.critics_score.title	string	No	Tomatometer	Name of the score, such as `Tomatometer` or `Popcornmeter`.
data.description	string	No		Short synopsis of the movie.
data.directors	array	No		Directors of the movie.
data.directors[].image_url	string	No		URL of the person's photo.
data.directors[].name	string	No	Christopher Nolan	Name of the person.
data.directors[].url	string	No	https://www.rottentomatoes.com/celebrity/christopher_nolan	Rotten Tomatoes page URL of the person.
data.ems_id	string	No	afbf1c81-1bfe-3996-9cbc-2e1be23d1f61	Rotten Tomatoes' own unique id of the movie.
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.genres	array	No	Sci-Fi	Genres of the movie.
data.image_url	string	No		URL of the poster image.
data.media_type	string	No	Movie	Kind of title, such as `Movie`.
data.path	string	No	/m/inception	Rotten Tomatoes path of the movie page, such as `/m/inception`.
data.producers	array	No		Producers of the movie.
data.producers[].image_url	string	No		URL of the person's photo.
data.producers[].name	string	No	Christopher Nolan	Name of the person.
data.producers[].url	string	No	https://www.rottentomatoes.com/celebrity/christopher_nolan	Rotten Tomatoes page URL of the person.
data.public_page_derived	boolean	No	true	Always `true`: the data comes from publicly visible Rotten Tomatoes pages.
data.release_date	string	No	2010-07-16	Release date of the movie, such as `2010-07-16`.
data.reviews_url	string	No	https://www.rottentomatoes.com/m/inception/reviews/all-audience	URL of the Rotten Tomatoes page with the audience reviews of the movie.
data.source_url	string	No	https://www.rottentomatoes.com/m/inception	URL the data was read from.
data.title	string	No	Inception	Title of the movie, as Rotten Tomatoes shows it.
data.url	string	No	https://www.rottentomatoes.com/m/inception	Rotten Tomatoes page URL of the movie.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/movie" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Rotten Tomatoes movie detail API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Rotten Tomatoes movie detail API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related