Docs menu

Rotten Tomatoes API endpoint

Rotten Tomatoes movie search API

Searches Rotten Tomatoes movies by the required `query`, returning up to `limit` rows (default 10, max 20). Each row has the title, URL, release year or start and end year, `tomatometer_score` and sentiment, `certified_fresh`, cast and image. No matches returns an empty `results` array.

GETapiKey2 credits/requestRotten Tomatoesrottentomatoes.searchResponseDoc/rottentomatoes/search

Endpoint facts

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

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

How this endpoint behaves

Query parameters:

query required string search text.
limit optional integer rows to return. Defaults to 10, maximum 20.

Notable response behavior:

Returns movie rows from Rotten Tomatoes search.
A true no-results page returns an empty results array. Challenge pages or parser drift return an upstream error.

Live monitoring

Monitored request: GET /rottentomatoes/search?limit=2&query=inception
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.63 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/search?limit=10&query=inception
Items in results: 10
Fields filled in every checked item: 7
Fields empty in some or all items: 2

Field	Filled in, of 10 checked	Values in the sample
title	10	“Inception” and 9 other values
path	10	“/m/inception” and 9 other values
url	10	rottentomatoes.com
image_url	10	resizing.flixster.com
cast	10	“Leonardo DiCaprio,Joseph Gordon-Levitt,Elliot Page” and 9 other values
release_year	10	1,999 to 2,019, median 2,010
tomatometer_score	6	0 to 86, median 55
tomatometer_sentiment	6	NEGATIVE (4), POSITIVE (2)
certified_fresh	10	true in 1 of 10

Request parameters

Parameter	Type	Required	Description	Example
query	string	Yes	Search query	inception
limit	integer	No	Rows to return, default 10, max 20	10
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/search?query=inception&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "inception",
    "limit": 2,
    "results": [
      {
        "title": "Inception",
        "path": "/m/inception",
        "url": "https://www.rottentomatoes.com/m/inception",
        "release_year": "2010",
        "tomatometer_score": 87,
        "tomatometer_sentiment": "POSITIVE"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.searchResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	rottentomatoes.SearchResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.limit	integer	No	10	Maximum number of results requested.
data.query	string	No	inception	Query that was run.
data.results	array	No		Titles matching the query.
data.results[].cast	string	No	Leonardo DiCaprio,Joseph Gordon-Levitt,Elliot Page	Names of the leading cast, separated by commas.
data.results[].certified_fresh	boolean	No	true	Whether the title is Certified Fresh.
data.results[].end_year	string	No		Last year of the title's run, as shown on the search row.
data.results[].image_url	string	No		URL of the poster image.
data.results[].path	string	No	/m/inception	Rotten Tomatoes path of the title page, such as `/m/inception`.
data.results[].release_year	string	No	2010	Release year of the title, such as `2010`.
data.results[].start_year	string	No		First year of the title's run, as shown on the search row.
data.results[].title	string	No	Inception	Title name as shown on the search row.
data.results[].tomatometer_score	integer	No	87	Tomatometer critics score, as a percentage.
data.results[].tomatometer_sentiment	string	No	POSITIVE	Tomatometer sentiment, such as `POSITIVE`.
data.results[].url	string	No	https://www.rottentomatoes.com/m/inception	Rotten Tomatoes page URL of the title.
data.source_url	string	No	https://www.rottentomatoes.com/search?search=inception	URL the data was read from.
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/search?query=inception&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 search API

GETapiKey2 credits/requestRotten Tomatoesrottentomatoes.searchResponseDoc/rottentomatoes/search

Endpoint facts

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

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

How this endpoint behaves

Query parameters:

query required string search text.
limit optional integer rows to return. Defaults to 10, maximum 20.

Notable response behavior:

Returns movie rows from Rotten Tomatoes search.
A true no-results page returns an empty results array. Challenge pages or parser drift return an upstream error.

Live monitoring

Monitored request: GET /rottentomatoes/search?limit=2&query=inception
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.63 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /rottentomatoes/search?limit=10&query=inception
Items in results: 10
Fields filled in every checked item: 7
Fields empty in some or all items: 2

Field	Filled in, of 10 checked	Values in the sample
title	10	“Inception” and 9 other values
path	10	“/m/inception” and 9 other values
url	10	rottentomatoes.com
image_url	10	resizing.flixster.com
cast	10	“Leonardo DiCaprio,Joseph Gordon-Levitt,Elliot Page” and 9 other values
release_year	10	1,999 to 2,019, median 2,010
tomatometer_score	6	0 to 86, median 55
tomatometer_sentiment	6	NEGATIVE (4), POSITIVE (2)
certified_fresh	10	true in 1 of 10

Request parameters

Parameter	Type	Required	Description	Example
query	string	Yes	Search query	inception
limit	integer	No	Rows to return, default 10, max 20	10
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/search?query=inception&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "inception",
    "limit": 2,
    "results": [
      {
        "title": "Inception",
        "path": "/m/inception",
        "url": "https://www.rottentomatoes.com/m/inception",
        "release_year": "2010",
        "tomatometer_score": 87,
        "tomatometer_sentiment": "POSITIVE"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/rottentomatoes.searchResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	rottentomatoes.SearchResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.limit	integer	No	10	Maximum number of results requested.
data.query	string	No	inception	Query that was run.
data.results	array	No		Titles matching the query.
data.results[].cast	string	No	Leonardo DiCaprio,Joseph Gordon-Levitt,Elliot Page	Names of the leading cast, separated by commas.
data.results[].certified_fresh	boolean	No	true	Whether the title is Certified Fresh.
data.results[].end_year	string	No		Last year of the title's run, as shown on the search row.
data.results[].image_url	string	No		URL of the poster image.
data.results[].path	string	No	/m/inception	Rotten Tomatoes path of the title page, such as `/m/inception`.
data.results[].release_year	string	No	2010	Release year of the title, such as `2010`.
data.results[].start_year	string	No		First year of the title's run, as shown on the search row.
data.results[].title	string	No	Inception	Title name as shown on the search row.
data.results[].tomatometer_score	integer	No	87	Tomatometer critics score, as a percentage.
data.results[].tomatometer_sentiment	string	No	POSITIVE	Tomatometer sentiment, such as `POSITIVE`.
data.results[].url	string	No	https://www.rottentomatoes.com/m/inception	Rotten Tomatoes page URL of the title.
data.source_url	string	No	https://www.rottentomatoes.com/search?search=inception	URL the data was read from.
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/search?query=inception&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 search 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 search 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