Docs menu

Rotten Tomatoes API endpoint

Rotten Tomatoes movie reviews API

Returns critic or audience reviews from Rotten Tomatoes, including pagination metadata. Pass exactly one of `path` or `url`. Supported `type` values are `critics`, `top-critics`, `audience`, and `verified-audience`.

GETapiKey3 credits/requestRotten Tomatoesrottentomatoes.reviewsResponseDoc/rottentomatoes/movie/reviews

Endpoint facts

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

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

How this endpoint behaves

Returns critic or audience reviews for a Rotten Tomatoes movie.

Query parameters:

path: Rotten Tomatoes movie path, for example /m/inception.
url: absolute https://www.rottentomatoes.com movie URL.
type: review type. Allowed values: critics, top-critics, audience, verified-audience.
limit: reviews to return. Defaults to 10; maximum 20.
after: optional pagination cursor from data.page_info.end_cursor.

Notable response behavior:

data.public_page_derived is true.
data.page_info.has_next_page and data.page_info.end_cursor expose Rotten Tomatoes pagination state when another page is available.
Review type values other than critics, top-critics, audience, and verified-audience are rejected before upstream IO.
Blocked pages, malformed review JSON, and parser drift return upstream errors.

Live monitoring

Monitored request: GET /rottentomatoes/movie/reviews?limit=5&path=%2Fm%2Finception&type=critics
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.74 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/movie/reviews?limit=10&path=%2Fm%2Finception&type=critics
Items in reviews: 6
Fields filled in every checked item: 17
Fields empty in some or all items: 1

Field	Filled in, of 6 checked	Values in the sample
type	6
display_name	6
publication	6
created_at	6
review	6	median 116 characters
score_sentiment	6
top_review	6	true in 0 of 6
top_critic	6	true in 1 of 6
top_publication	6	true in 3 of 6
tomatometer_approved	6	true in 3 of 6
publication_approved	6	true in 4 of 6
verified	6	true in 0 of 6
super_reviewer	6	true in 0 of 6
has_spoilers	6	true in 0 of 6
has_profanity	6	true in 0 of 6
critic_url	6	rottentomatoes.com
publication_review_url	6	thetimes.co.uk and 5 other hosts
original_score	2

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
type	string	No	Review type: critics, top-critics, audience, verified-audience Allowed values: critics, top-critics, audience, verified-audience.	critics
limit	integer	No	Reviews to return, default 10, max 20	10
after	string	No	Pagination cursor from data.page_info.end_cursor
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/movie/reviews?type=critics&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "type": "critics",
    "limit": 10,
    "page_info": {
      "has_next_page": true,
      "end_cursor": "eyJ0eXBlIjoiUmV2aWV3In0"
    },
    "reviews": [
      {
        "display_name": "Danilo Castro",
        "review": "A representative review excerpt."
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.reviewsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	rottentomatoes.ReviewsResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z
data.limit	integer	No	10
data.movie	rottentomatoes.ReviewMovieSummary	No
data.movie.ems_id	string	No	afbf1c81-1bfe-3996-9cbc-2e1be23d1f61
data.movie.media_type	string	No	Movie
data.movie.path	string	No	/m/inception
data.movie.title	string	No	Inception
data.movie.url	string	No	https://www.rottentomatoes.com/m/inception
data.page_info	rottentomatoes.ReviewPageInfo	No
data.page_info.end_cursor	string	No	Mjk=	Cursor of the last item on this page. Pass it as `after` to get the next page.
data.page_info.has_next_page	boolean	No	true	Whether more items follow this page.
data.page_info.has_previous_page	boolean	No	true	Whether items precede this page.
data.page_info.start_cursor	string	No	MA==	Cursor of the first item on this page.
data.public_page_derived	boolean	No	true
data.reviews	array	No
data.reviews[].created_at	string	No	2024-04-11T23:40:16.000Z
data.reviews[].critic_url	string	No	https://www.rottentomatoes.com/critic/danilo-castro
data.reviews[].display_name	string	No	Danilo Castro
data.reviews[].has_profanity	boolean	No	false
data.reviews[].has_spoilers	boolean	No	false
data.reviews[].id	string	No	102903742
data.reviews[].original_score	string	No	9/10
data.reviews[].publication	string	No	Next Best Picture
data.reviews[].publication_approved	boolean	No	true
data.reviews[].publication_review_url	string	No	https://nextbestpicture.com/inception/
data.reviews[].rating	number	No	4.5
data.reviews[].rating_label	string	No	STAR_4_5
data.reviews[].review	string	No
data.reviews[].score_sentiment	string	No	POSITIVE
data.reviews[].super_reviewer	boolean	No	false
data.reviews[].tomatometer_approved	boolean	No	true
data.reviews[].top_critic	boolean	No	false
data.reviews[].top_publication	boolean	No	false
data.reviews[].top_review	boolean	No	false
data.reviews[].type	string	No	critic
data.reviews[].verified	boolean	No	false
data.reviews_api_url	string	No	https://www.rottentomatoes.com/napi/rtcf/v1/movies/afbf1c81-1bfe-3996-9cbc-2e1be23d1f61/reviews?type=critic&pageCount=10
data.source_url	string	No	https://www.rottentomatoes.com/m/inception/reviews
data.type	string	No	critics
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/reviews?type=critics&limit=10" \
  -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 reviews API

GETapiKey3 credits/requestRotten Tomatoesrottentomatoes.reviewsResponseDoc/rottentomatoes/movie/reviews

Endpoint facts

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

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

How this endpoint behaves

Returns critic or audience reviews for a Rotten Tomatoes movie.

Query parameters:

path: Rotten Tomatoes movie path, for example /m/inception.
url: absolute https://www.rottentomatoes.com movie URL.
type: review type. Allowed values: critics, top-critics, audience, verified-audience.
limit: reviews to return. Defaults to 10; maximum 20.
after: optional pagination cursor from data.page_info.end_cursor.

Notable response behavior:

data.public_page_derived is true.
data.page_info.has_next_page and data.page_info.end_cursor expose Rotten Tomatoes pagination state when another page is available.
Review type values other than critics, top-critics, audience, and verified-audience are rejected before upstream IO.
Blocked pages, malformed review JSON, and parser drift return upstream errors.

Live monitoring

Monitored request: GET /rottentomatoes/movie/reviews?limit=5&path=%2Fm%2Finception&type=critics
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.74 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/movie/reviews?limit=10&path=%2Fm%2Finception&type=critics
Items in reviews: 6
Fields filled in every checked item: 17
Fields empty in some or all items: 1

Field	Filled in, of 6 checked	Values in the sample
type	6
display_name	6
publication	6
created_at	6
review	6	median 116 characters
score_sentiment	6
top_review	6	true in 0 of 6
top_critic	6	true in 1 of 6
top_publication	6	true in 3 of 6
tomatometer_approved	6	true in 3 of 6
publication_approved	6	true in 4 of 6
verified	6	true in 0 of 6
super_reviewer	6	true in 0 of 6
has_spoilers	6	true in 0 of 6
has_profanity	6	true in 0 of 6
critic_url	6	rottentomatoes.com
publication_review_url	6	thetimes.co.uk and 5 other hosts
original_score	2

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
type	string	No	Review type: critics, top-critics, audience, verified-audience Allowed values: critics, top-critics, audience, verified-audience.	critics
limit	integer	No	Reviews to return, default 10, max 20	10
after	string	No	Pagination cursor from data.page_info.end_cursor
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/movie/reviews?type=critics&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "type": "critics",
    "limit": 10,
    "page_info": {
      "has_next_page": true,
      "end_cursor": "eyJ0eXBlIjoiUmV2aWV3In0"
    },
    "reviews": [
      {
        "display_name": "Danilo Castro",
        "review": "A representative review excerpt."
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.reviewsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	rottentomatoes.ReviewsResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z
data.limit	integer	No	10
data.movie	rottentomatoes.ReviewMovieSummary	No
data.movie.ems_id	string	No	afbf1c81-1bfe-3996-9cbc-2e1be23d1f61
data.movie.media_type	string	No	Movie
data.movie.path	string	No	/m/inception
data.movie.title	string	No	Inception
data.movie.url	string	No	https://www.rottentomatoes.com/m/inception
data.page_info	rottentomatoes.ReviewPageInfo	No
data.page_info.end_cursor	string	No	Mjk=	Cursor of the last item on this page. Pass it as `after` to get the next page.
data.page_info.has_next_page	boolean	No	true	Whether more items follow this page.
data.page_info.has_previous_page	boolean	No	true	Whether items precede this page.
data.page_info.start_cursor	string	No	MA==	Cursor of the first item on this page.
data.public_page_derived	boolean	No	true
data.reviews	array	No
data.reviews[].created_at	string	No	2024-04-11T23:40:16.000Z
data.reviews[].critic_url	string	No	https://www.rottentomatoes.com/critic/danilo-castro
data.reviews[].display_name	string	No	Danilo Castro
data.reviews[].has_profanity	boolean	No	false
data.reviews[].has_spoilers	boolean	No	false
data.reviews[].id	string	No	102903742
data.reviews[].original_score	string	No	9/10
data.reviews[].publication	string	No	Next Best Picture
data.reviews[].publication_approved	boolean	No	true
data.reviews[].publication_review_url	string	No	https://nextbestpicture.com/inception/
data.reviews[].rating	number	No	4.5
data.reviews[].rating_label	string	No	STAR_4_5
data.reviews[].review	string	No
data.reviews[].score_sentiment	string	No	POSITIVE
data.reviews[].super_reviewer	boolean	No	false
data.reviews[].tomatometer_approved	boolean	No	true
data.reviews[].top_critic	boolean	No	false
data.reviews[].top_publication	boolean	No	false
data.reviews[].top_review	boolean	No	false
data.reviews[].type	string	No	critic
data.reviews[].verified	boolean	No	false
data.reviews_api_url	string	No	https://www.rottentomatoes.com/napi/rtcf/v1/movies/afbf1c81-1bfe-3996-9cbc-2e1be23d1f61/reviews?type=critic&pageCount=10
data.source_url	string	No	https://www.rottentomatoes.com/m/inception/reviews
data.type	string	No	critics
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/reviews?type=critics&limit=10" \
  -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 reviews 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 reviews 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