Endpoint Playground
Returns the details of up to 20 Rotten Tomatoes movies in one call, in the order requested. Each entry carries the title, synopsis, path and URL, `ems_id`, runtime, release date/year, production companies, the release runs with distributors, the Tomatometer and Popcornmeter scores, the score variants for all critics, top critics, all audience and verified audience, the critics and audience consensus, and `where_to_watch`: the public streaming, rental and purchase offers with provider name, link, licence, quality, price and availability date. Those are public provider pages, not playable media URLs. Identifiers that resolve to nothing are listed in `data.not_found` instead of failing the call. Pass exactly one of `ids` (Rotten Tomatoes `ems_id` values) or `paths` (Rotten Tomatoes movie paths or URLs); the `paths` form resolves each path first, so it costs one extra upstream read per path. The headline Tomatometer and Popcornmeter carry no counts; review and rating counts are in the score variants (for the number of critic reviews read `scores.critics_all.review_count`). Review samples are not returned here: use `/rottentomatoes/movie/reviews` for reviews. `data.fetched_at` is the UTC fetch time.
curl 'https://api.crawlora.net/api/v1/rottentomatoes/movies' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| ids | string | No | Comma-separated Rotten Tomatoes ems_id values, 1 to 20 | |
| paths | string | No | Comma-separated Rotten Tomatoes movie paths or URLs, 1 to 20 |
{
"code": 200,
"data": {
"movies": [
{
"ems_id": "d5639ed5-2dfe-44a3-8ed2-1cb3ea99855f",
"path": "/m/clayface",
"url": "https://www.rottentomatoes.com/m/clayface",
"title": "Clayface",
"description": "\"Clayface\" unravels one man's horrifying descent from rising Hollywood star to\nrevenge-filled monster in a story that explores the loss of one's identity and humanity,\ncorrosive love, and the dark underbelly of scientific ambition.",
"media_type": "Movie",
"release_date": "2026-10-23",
"release_year": "2026",
"runtime_minutes": 108,
"rotten_tomatoes_id": "900109434",
"fandango_id": "244768",
"poster_url": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/O8G8HZEBw1uKp4Sc2X4VFjg0KUI=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzL2M0MzFlZWJlLTc1NWUtNGQ0YS1iYjc5LTZlZTRhZTBhNWU5YS5qcGc=",
"image_url": "https://resizing.flixster.com/O8G8HZEBw1uKp4Sc2X4VFjg0KUI=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzL2M0MzFlZWJlLTc1NWUtNGQ0YS1iYjc5LTZlZTRhZTBhNWU5YS5qcGc=",
"production_companies": [
"6th & Idaho Productions",
"DC Studios"
],
"releases": [
{
"date": "2026-10-23",
"type": "WIDE",
"country": "USA",
"distributors": [
"Warner Bros. Pictures"
]
}
],
"critics_score": {
"score": 77,
"score_percent": "77%",
"sentiment": "POSITIVE",
"certified": true
},
"audience_score": {
"score": 94,
"score_percent": "94%",
"sentiment": "POSITIVE",
"certified": true,
"score_type": "VERIFIED"
},
"scores": {
"critics_all": {
"score": 77,
"score_percent": "77%",
"sentiment": "POSITIVE",
"average_rating": "6.60",
"rating_count": 193,
"review_count": 193,
"liked_count": 148,
"not_liked_count": 45,
"certified": true
},
"critics_top": {
"score": 72,
"score_percent": "72%",
"sentiment": "POSITIVE",
"average_rating": "6.20",
"rating_count": 36,
"review_count": 36,
"liked_count": 26,
"not_liked_count": 10,
"certified": true
},
"audience_all": {
"score": 94,
"score_percent": "94%",
"sentiment": "POSITIVE",
"average_rating": "4.5",
"review_count": 2866,
"liked_count": 7632,
"not_liked_count": 526,
"certified": true,
"score_type": "ALL",
"banded_rating_count": "5,000+"
},
"audience_verified": {
"score": 94,
"score_percent": "94%",
"sentiment": "POSITIVE",
"average_rating": "4.4",
"review_count": 983,
"liked_count": 3406,
"not_liked_count": 225,
"certified": true,
"score_type": "VERIFIED",
"banded_rating_count": "2,500+"
}
},
"critics_consensus": "Carving out a unique identity for itself in the DCU while closely resembling a litany of body horror classics, <em>Clayface</em> takes time to get going until it eventually morphs into an icky and satisfying revenge thriller.",
"audience_consensus": "A refreshingly twisted tale of revenge, <em>Clayface</em> is a horror-fueled comic book adaptation that breaks from conventions while still delivering a satisfying emotional core.",
"where_to_watch": [
{
"name": "Fandango",
"provider_id": "fandango",
"license": "buy tickets"
},
{
"name": "Fandango",
"provider_id": "70906",
"title": "Clayface",
"url": "https://athome.fandango.com/content/browse/details/Clayface/5147269",
"license": "purchase",
"quality": "UHD",
"price": "24.99",
"availability_date": "2026-12-07T20:00:00",
"preorder": true
}
],
"call_to_action": {
"button_text": "Buy Tickets",
"window_text": "Now in Theaters",
"name": "Fandango",
"lifecycle_date": "2026-10-23"
},
"lifecycle": {
"lifecycle": "IN_THEATERS",
"date": "2026-10-23"
},
"has_critics_all": true,
"has_critics_top": true,
"has_audience_all": true,
"has_audience_verified": true
}
],
"not_found": [
"00000000-0000-4000-8000-000000000000"
],
"fetched_at": "2026-10-30T02:15:04Z"
},
"msg": "OK"
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.