{ "openapi": "3.0.0", "paths": { "/api/main/message": { "get": { "description": "Returns a simple provider readiness message.", "operationId": "Get provider message", "parameters": [], "responses": { "200": { "description": "Provider message.", "content": { "application/json": { "schema": { "type": "object", "properties": { "provider": { "type": "string", "example": "rottentomatoes" }, "message": { "type": "string", "example": "Rotten Tomatoes provider is ready." } } }, "example": { "provider": "rottentomatoes", "message": "Rotten Tomatoes provider is ready." } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get provider message", "tags": [ "Main" ] } }, "/api/main/fetch": { "get": { "description": "Fetches a public API path or URL using got with HTTP/2.", "operationId": "Fetch URL with got HTTP/2", "parameters": [ { "name": "url", "required": false, "in": "query", "description": "Absolute public API URL.", "schema": { "example": "https://public-api.rottentomatoes.com/v1/search", "type": "string" } }, { "name": "path", "required": false, "in": "query", "description": "Public API path.", "schema": { "example": "/v1/search", "type": "string" } } ], "responses": { "200": { "description": "got HTTP/2 response body." } }, "summary": "Fetch URL with got HTTP/2", "tags": [ "Main" ] } }, "/api/feeds/featured": { "get": { "operationId": "Get featured feed", "parameters": [ { "name": "limit", "required": false, "in": "query", "description": "Limit value forwarded exactly when provided. No default is injected.", "schema": { "example": "20", "type": "string" } } ], "responses": { "200": { "description": "Featured feed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "linkUrl": { "type": "string", "example": "https://editorial.rottentomatoes.com/article/comic-con-2026-news-updates/" }, "pubDate": { "type": "string" }, "postType": { "type": "string" }, "subtitle": { "type": "string" }, "aspectRatio": { "type": "string" }, "featureLabel": { "type": "string" }, "activityType": { "type": "string" }, "actor": { "type": "string" }, "foreign_id": { "type": "string", "nullable": true }, "ctaText": { "type": "string" }, "image": { "type": "string" }, "openInWebview": { "type": "boolean" }, "reactionSummary": { "type": "object", "properties": { "reactions": { "type": "array", "items": { "type": "object", "additionalProperties": {} } }, "totalCount": { "type": "integer" }, "updateDateTime": { "type": "string" }, "activityType": { "type": "string" }, "activityId": { "type": "string" }, "postType": { "type": "string" } } }, "emsId": { "type": "string" }, "publicId": { "type": "string" }, "mediaType": { "type": "string" }, "includeAds": { "type": "boolean" }, "mediaProfile": { "type": "object", "properties": { "posterUri": { "type": "string" }, "title": { "type": "string" }, "vanity": { "type": "string" }, "rottenTomatoesUrl": { "type": "string" }, "audienceScore": { "type": "object", "properties": { "scoreType": { "type": "string" }, "score": { "type": "string" }, "scoreSentiment": { "type": "string" }, "certified": { "type": "boolean" } } }, "tomatometerScore": { "type": "object", "properties": { "score": { "type": "string" }, "scoreSentiment": { "type": "string" }, "certified": { "type": "boolean" } } }, "releaseYear": { "type": "string" }, "hasShowtimes": { "type": "boolean" }, "fandangoUrl": { "type": "string" } } }, "photos": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "title": { "type": "string" } } } }, "adUnitId": { "type": "string", "example": "/5727661/RottenTomatoes_FlexCard" }, "position": { "type": "string", "example": "4" }, "variables": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "value": { "type": "string" } } } } } } }, "pageInfo": { "type": "object", "properties": { "next": { "type": "string", "example": "14-0" } } } } }, "example": { "data": [ { "title": "On the Ground at Comic-Con", "linkUrl": "https://editorial.rottentomatoes.com/article/comic-con-2026-news-updates/", "pubDate": "2026-07-24T00:00:00.000Z", "postType": "editorial", "subtitle": "Day 1 previews Ray Gunn, new trailers, and more. ", "aspectRatio": "16:9 (Landscape)", "featureLabel": "Comic-Con 2026", "activityType": "list", "actor": "K1Oc4NTBjUpNhALFN8cmWInouwe", "foreign_id": "https%3A%2F%2Feditorial.rottentomatoes.com%2Farticle%2Fcomic-con-2026-news-updates%2F_July 24, 2026 ", "ctaText": "Read Article", "image": "https://editorial.rottentomatoes.com/wp-content/uploads/2026/07/Comic-Con_2026-Day_1-Stuart_Fails_to_Save_the_Universe.jpg", "openInWebview": false, "reactionSummary": { "reactions": [ "6 items" ], "totalCount": 2, "updateDateTime": "2026-07-24T15:14:15.504Z", "activityType": "list", "activityId": "https%3A%2F%2Feditorial.rottentomatoes.com%2Farticle%2Fcomic-con-2026-news-updates%2F_July 24, 2026 ", "postType": "editorial" } }, { "emsId": "3d8715e6-f32f-4c44-a1c6-ceeec81967c1", "title": "Penelope’s Layers in 'The Odyssey'", "pubDate": "2026-07-24T00:00:00.000Z", "postType": "video", "publicId": "k2n5G4xz3opB", "subtitle": "\"There wasn't a ton of space given to her.\" — Anne Hathaway on her character and working with Christopher Nolan. ", "mediaType": "movie", "aspectRatio": "9:16 (Vertical)", "featureLabel": "RT Interview", "activityType": "list", "actor": "K1Oc4NTBjUpNhALFN8cmWInouwe", "foreign_id": "k2n5G4xz3opB", "image": "https://images.fandango.com/cms/assets/b4e7aee0-8772-11f1-a158-a1288b53df76--anne-vertical-2.jpg", "includeAds": false, "openInWebview": false, "reactionSummary": { "reactions": [ "6 items" ], "totalCount": 0, "activityType": "list", "activityId": "k2n5G4xz3opB", "postType": "video" }, "mediaProfile": { "posterUri": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/A6I9ex8FRe7tDW-mI3eP3tx_HmE=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzkyOGVlMzAxLThhN2ItNGYyMy04NzdjLTYyNTEyMDRmYTQzOS5qcGc=", "title": "The Odyssey", "vanity": "the_odyssey_2026", "rottenTomatoesUrl": "https://www.rottentomatoes.com/m/the_odyssey_2026", "audienceScore": { "keys": [ "scoreType", "score", "scoreSentiment", "certified" ] }, "tomatometerScore": { "keys": [ "score", "scoreSentiment", "certified" ] }, "releaseYear": "2026", "hasShowtimes": true, "fandangoUrl": "https://www.fandango.com/the-odyssey-2026-241283/movie-overview" } }, { "title": "Poster Round-Up", "photos": [ { "keys": [ "url", "title" ] }, { "keys": [ "url", "title" ] }, { "keys": [ "url", "title" ] } ], "ctaText": "See more", "pubDate": "2026-07-24T00:00:00.000Z", "postType": "photoGallery", "subtitle": "Coming soon to theaters and streamers", "aspectRatio": "4:5", "featureLabel": "Coming Soon", "activityType": "list", "actor": "K1Oc4NTBjUpNhALFN8cmWInouwe", "foreign_id": "dc49988d1de32fef0ec7f54d538b98a0c0ba572b", "image": "https://images.fandango.com/cms/assets/a0cf69e0-7880-11f0-8321-2b978811c524--high-potential-poster.jpg", "openInWebview": false, "reactionSummary": { "reactions": [ "6 items" ], "totalCount": 89, "updateDateTime": "2026-07-24T08:42:14.313Z", "activityType": "list", "activityId": "dc49988d1de32fef0ec7f54d538b98a0c0ba572b", "postType": "photoGallery" } } ], "pageInfo": { "next": "14-0" } } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get featured feed", "tags": [ "Feeds" ] } }, "/api/discovery/coming-soon": { "get": { "operationId": "Get coming-soon movies", "parameters": [ { "name": "after", "required": false, "in": "query", "description": "Pagination cursor returned by the upstream list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "before", "required": false, "in": "query", "description": "Reverse pagination cursor returned by the upstream list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "sort", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "upcoming", "newest", "title_az", "tomatometer_descending", "tomatometer_ascending" ] } }, { "name": "genres", "required": false, "in": "query", "description": "Genre values. Enter one or more values as a comma-separated string, for example \"action,comedy\". The API splits this input by \",\" before forwarding upstream. Allowed values: action, adventure, animation, anime, biography, comedy, crime, documentary, drama, entertainment, faith_and_spirituality, fantasy, game_show, health_and_wellness, history, holiday, horror, house_and_garden, kids_and_family, lgbtq, music, musical, mystery_and_thriller, nature, news, reality, romance, sci_fi, short, soap, special_interest, sports, stand_up, talk_show, travel, variety, war, western.", "schema": { "example": "action,comedy", "type": "string" } }, { "name": "ratings", "required": false, "in": "query", "description": "Movie rating values. Enter one or more values as a comma-separated string. The API splits this input by \",\" before forwarding upstream. Allowed values: g, pg, pg_13, r, nc_17, unrated.", "schema": { "type": "string" } }, { "name": "critics", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "all", "certified_fresh", "fresh", "rotten" ] } } ], "responses": { "200": { "description": "Coming-soon movies.", "content": { "application/json": { "schema": { "type": "object", "properties": { "affiliates": { "type": "object", "properties": { "id": { "type": "integer", "example": 29288 }, "slug": { "type": "string", "example": "rt-discovery-affiliates" }, "title": { "type": "string", "example": "CM-42969 Fandango at home name and logo" }, "content": { "type": "array", "items": { "type": "object", "properties": { "icon": { "type": "string" }, "name": { "type": "string" }, "value": { "type": "string" }, "id": { "type": "integer" }, "ovdHosts": { "type": "array", "items": { "type": "string" } }, "showFilter": { "type": "boolean" } } } }, "dateStart": { "type": "string", "example": "2026-07-15T13:00:00.000Z" } } }, "filters": { "type": "object", "properties": { "audience": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "value": { "type": "string" }, "sentiment": { "type": "string" }, "certified": { "type": "boolean" } } } }, "critics": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "value": { "type": "string" }, "sentiment": { "type": "string" }, "certified": { "type": "boolean" } } } }, "genres": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "ratings": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "resetFiltersClass": { "type": "string", "example": "" }, "sort": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } } } }, "coming-soon": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "emsId": { "type": "string" }, "primaryImageUrl": { "type": "string" }, "primaryVideo": { "type": "object", "properties": { "contentType": { "type": "string" }, "publicId": { "type": "string" }, "mpxId": { "type": "string" }, "title": { "type": "string" } } }, "releaseYear": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" }, "vanity": { "type": "string" }, "audienceScore": { "type": "object", "properties": { "score": { "type": "string" }, "scoreSentiment": { "type": "string" }, "certified": { "type": "boolean" } } }, "tomatometerScore": { "type": "object", "properties": { "score": { "type": "string" }, "certified": { "type": "boolean" }, "scoreSentiment": { "type": "string" } } } } } }, "pageInfo": { "type": "object", "properties": { "startCursor": { "type": "string", "example": "MA==" }, "endCursor": { "type": "string", "example": "MTk=" }, "hasNextPage": { "type": "boolean", "example": true }, "hasPreviousPage": { "type": "boolean", "example": false } } }, "totalCount": { "type": "integer", "example": 240 } } } } }, "example": { "affiliates": { "id": 29288, "slug": "rt-discovery-affiliates", "title": "CM-42969 Fandango at home name and logo", "content": [ { "icon": "in-theaters", "name": "Theaters", "value": "theaters" }, { "id": 70906, "icon": "fandango", "name": "Fandango", "value": "fandango", "ovdHosts": [ "1 items" ], "showFilter": true }, { "id": 113064, "icon": "apple-tv-plus-us", "name": "Apple TV", "value": "apple-tv-plus", "ovdHosts": [ "1 items" ], "showFilter": true } ], "dateStart": "2026-07-15T13:00:00.000Z" }, "filters": { "audience": [ { "name": "Verified Hot", "description": "A special distinction awarded to the highest verified theatrical movies.", "value": "verified_hot", "sentiment": "positive", "certified": true }, { "name": "Hot", "description": "At least 60% of user ratings for a movie or TV show are positive.", "value": "upright", "sentiment": "positive", "certified": false }, { "name": "Stale", "description": "Less than 60% of user ratings for a movie or TV show are positive.", "value": "spilled", "sentiment": "negative", "certified": false } ], "critics": [ { "name": "Certified Fresh", "description": "A special distinction awarded to the best reviewed movies and TV shows.", "value": "certified_fresh", "sentiment": "positive", "certified": true }, { "name": "Fresh", "description": "At least 60% of reviews for a movie or TV show are positive.", "value": "fresh", "sentiment": "positive", "certified": false }, { "name": "Rotten", "description": "Less than 60% of reviews for a movie or TV show are positive.", "value": "rotten", "sentiment": "negative", "certified": false } ], "genres": [ { "name": "Action", "value": "action" }, { "name": "Adventure", "value": "adventure" }, { "name": "Animation", "value": "animation" } ], "ratings": [ { "name": "G", "value": "g" }, { "name": "PG", "value": "pg" }, { "name": "PG-13", "value": "pg_13" } ], "resetFiltersClass": "", "sort": [ { "name": "Most popular", "value": "popular" }, { "name": "Newest", "value": "newest" }, { "name": "A → Z", "value": "a_z" } ] }, "coming-soon": { "list": [ { "emsId": "77ae9f13-4b61-359b-9b8b-7eb9ef58aa2f", "primaryImageUrl": "https://resizing.flixster.com/ZHyyBm23-mTJt3amh35jonrpp8g=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzL2ZlM2JjOWQ3LWFjYzAtNDM5OS04MTE5LWNkOTBhZjliYmQ1Mi5qcGc=", "primaryVideo": { "keys": [ "contentType", "publicId", "mpxId", "title" ] }, "releaseYear": "2026", "title": "WHAM! 10 Days in China", "type": "Movie", "vanity": "wham_10_days_in_china" }, { "emsId": "2759de5a-3571-4fd3-924a-a3f94538aeb9", "primaryImageUrl": "https://resizing.flixster.com/c3yJo5qKpFMm6ZoBZE_wI7ITlKw=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzQzODE1YzBlLWNlOWYtNDU5Mi1hNzkxLTMyMzQ4OTEyYmMwNS5qcGc=", "releaseYear": "2026", "title": "Above and Below", "type": "Movie", "vanity": "above_and_below_2026" }, { "audienceScore": { "keys": [ "score", "scoreSentiment", "certified" ] }, "emsId": "ed6cb2f2-5c4a-3d90-90fd-d9a3409ffb8b", "primaryImageUrl": "https://resizing.flixster.com/Tf4Oa0wtLxa9Bm5pmvBWk-Oew2E=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzllZDhmNTJmLTZlNWMtNDAwZi04NzcyLWZkNmY5NjUyZjFkYS5qcGc=", "primaryVideo": { "keys": [ "contentType", "publicId", "mpxId", "title" ] }, "releaseYear": "2014", "title": "Boyhood", "tomatometerScore": { "keys": [ "score", "certified", "scoreSentiment" ] }, "type": "Movie", "vanity": "boyhood" } ], "pageInfo": { "startCursor": "MA==", "endCursor": "MTk=", "hasNextPage": true, "hasPreviousPage": false }, "totalCount": 240 } } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get coming-soon movies", "tags": [ "Discovery" ] } }, "/api/discovery/in-theaters": { "get": { "operationId": "Get in-theaters movies", "parameters": [ { "name": "after", "required": false, "in": "query", "description": "Pagination cursor returned by the upstream list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "before", "required": false, "in": "query", "description": "Reverse pagination cursor returned by the upstream list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "sort", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "popular", "popularity", "newest", "top_box_office", "tomatometer_ascending", "tomatometer_descending", "audience_descending", "audience_ascending", "release_date_newest", "release_date_oldest", "title_az", "title_za" ] } }, { "name": "genres", "required": false, "in": "query", "description": "Genre values. Enter one or more values as a comma-separated string, for example \"action,comedy\". The API splits this input by \",\" before forwarding upstream. Allowed values: action, adventure, animation, anime, biography, comedy, crime, documentary, drama, entertainment, faith_and_spirituality, fantasy, game_show, health_and_wellness, history, holiday, horror, house_and_garden, kids_and_family, lgbtq, music, musical, mystery_and_thriller, nature, news, reality, romance, sci_fi, short, soap, special_interest, sports, stand_up, talk_show, travel, variety, war, western.", "schema": { "example": "action,comedy", "type": "string" } }, { "name": "ratings", "required": false, "in": "query", "description": "Movie rating values. Enter one or more values as a comma-separated string. The API splits this input by \",\" before forwarding upstream. Allowed values: g, pg, pg_13, r, nc_17, unrated.", "schema": { "type": "string" } }, { "name": "audience", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "all", "upright", "spilled", "verified_hot" ] } }, { "name": "critics", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "all", "certified_fresh", "fresh", "rotten" ] } } ], "responses": { "200": { "description": "In-theaters movies.", "content": { "application/json": { "schema": { "type": "object", "properties": { "affiliates": { "type": "object", "properties": { "id": { "type": "integer", "example": 29288 }, "slug": { "type": "string", "example": "rt-discovery-affiliates" }, "title": { "type": "string", "example": "CM-42969 Fandango at home name and logo" }, "content": { "type": "array", "items": { "type": "object", "properties": { "icon": { "type": "string" }, "name": { "type": "string" }, "value": { "type": "string" }, "id": { "type": "integer" }, "ovdHosts": { "type": "array", "items": { "type": "string" } }, "showFilter": { "type": "boolean" } } } }, "dateStart": { "type": "string", "example": "2026-07-15T13:00:00.000Z" } } }, "filters": { "type": "object", "properties": { "audience": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "value": { "type": "string" }, "sentiment": { "type": "string" }, "certified": { "type": "boolean" } } } }, "critics": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "value": { "type": "string" }, "sentiment": { "type": "string" }, "certified": { "type": "boolean" } } } }, "genres": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "ratings": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "resetFiltersClass": { "type": "string", "example": "" }, "sort": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } } } }, "in-theaters": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "emsId": { "type": "string" }, "primaryImageUrl": { "type": "string" }, "primaryVideo": { "type": "object", "properties": { "contentType": { "type": "string" }, "publicId": { "type": "string" }, "mpxId": { "type": "string" }, "title": { "type": "string" } } }, "releaseYear": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" }, "vanity": { "type": "string" }, "audienceScore": { "type": "object", "properties": { "score": { "type": "string", "example": "78" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "certified": { "type": "boolean", "example": false } } } } } }, "pageInfo": { "type": "object", "properties": { "startCursor": { "type": "string", "example": "MA==" }, "endCursor": { "type": "string", "example": "MTk=" }, "hasNextPage": { "type": "boolean", "example": true }, "hasPreviousPage": { "type": "boolean", "example": false } } }, "totalCount": { "type": "integer", "example": 33 } } } } }, "example": { "affiliates": { "id": 29288, "slug": "rt-discovery-affiliates", "title": "CM-42969 Fandango at home name and logo", "content": [ { "icon": "in-theaters", "name": "Theaters", "value": "theaters" }, { "id": 70906, "icon": "fandango", "name": "Fandango", "value": "fandango", "ovdHosts": [ "1 items" ], "showFilter": true }, { "id": 113064, "icon": "apple-tv-plus-us", "name": "Apple TV", "value": "apple-tv-plus", "ovdHosts": [ "1 items" ], "showFilter": true } ], "dateStart": "2026-07-15T13:00:00.000Z" }, "filters": { "audience": [ { "name": "Verified Hot", "description": "A special distinction awarded to the highest verified theatrical movies.", "value": "verified_hot", "sentiment": "positive", "certified": true }, { "name": "Hot", "description": "At least 60% of user ratings for a movie or TV show are positive.", "value": "upright", "sentiment": "positive", "certified": false }, { "name": "Stale", "description": "Less than 60% of user ratings for a movie or TV show are positive.", "value": "spilled", "sentiment": "negative", "certified": false } ], "critics": [ { "name": "Certified Fresh", "description": "A special distinction awarded to the best reviewed movies and TV shows.", "value": "certified_fresh", "sentiment": "positive", "certified": true }, { "name": "Fresh", "description": "At least 60% of reviews for a movie or TV show are positive.", "value": "fresh", "sentiment": "positive", "certified": false }, { "name": "Rotten", "description": "Less than 60% of reviews for a movie or TV show are positive.", "value": "rotten", "sentiment": "negative", "certified": false } ], "genres": [ { "name": "Action", "value": "action" }, { "name": "Adventure", "value": "adventure" }, { "name": "Animation", "value": "animation" } ], "ratings": [ { "name": "G", "value": "g" }, { "name": "PG", "value": "pg" }, { "name": "PG-13", "value": "pg_13" } ], "resetFiltersClass": "", "sort": [ { "name": "Most popular", "value": "popular" }, { "name": "Newest", "value": "newest" }, { "name": "Top Box Office", "value": "top_box_office" } ] }, "in-theaters": { "list": [ { "emsId": "e55584df-6be6-4b2e-b701-3f81d9ceb5da", "primaryImageUrl": "https://resizing.flixster.com/U-dGiCQMvrDLLGtpi8_AtpkIO8o=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzZhNDcwNjM2LWYwNmItNDAzMy1iNWEwLTdjOGVlNTMwYWI0Yi5qcGc=", "primaryVideo": { "keys": [ "contentType", "publicId", "mpxId", "title" ] }, "releaseYear": "2026", "title": "Splash City", "type": "Movie", "vanity": "splash_city" }, { "emsId": "eac09b34-4100-4358-a760-b72efcddb00e", "primaryImageUrl": "https://resizing.flixster.com/xzkis-mOSPISPrb6yftduvv4hLg=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzEzNGI5ZmNmLTk5OWMtNGQwZC04OThkLTQwODk5NzBmYjEyMC5qcGc=", "releaseYear": "2026", "title": "Anbe Diana", "type": "Movie", "vanity": "anbe_diana" }, { "emsId": "df648289-61fb-4343-b3d6-0cdd2e8f9655", "primaryImageUrl": "https://resizing.flixster.com/J44cPQrWWau0KCriPNEkZ4H9ZeI=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzNkNzhjNTdlLTk2NmUtNDE2Ni1iNWUxLWEzMzA5M2YyODc2MC5qcGc=", "primaryVideo": { "keys": [ "contentType", "publicId", "mpxId", "title" ] }, "releaseYear": "2025", "title": "Heavyweight", "type": "Movie", "vanity": "heavyweight_2025" } ], "pageInfo": { "startCursor": "MA==", "endCursor": "MTk=", "hasNextPage": true, "hasPreviousPage": false }, "totalCount": 33 } } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get in-theaters movies", "tags": [ "Discovery" ] } }, "/api/discovery/tv-series": { "get": { "operationId": "Get TV series", "parameters": [ { "name": "after", "required": false, "in": "query", "description": "Pagination cursor returned by the upstream list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "before", "required": false, "in": "query", "description": "Reverse pagination cursor returned by the upstream list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "sort", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "newest", "popularity", "tomatometer_ascending", "tomatometer_descending", "audience_descending", "audience_ascending", "a_z", "z_a" ] } }, { "name": "genres", "required": false, "in": "query", "description": "Genre values. Enter one or more values as a comma-separated string, for example \"action,comedy\". The API splits this input by \",\" before forwarding upstream. Allowed values: action, adventure, animation, anime, biography, comedy, crime, documentary, drama, entertainment, faith_and_spirituality, fantasy, game_show, health_and_wellness, history, holiday, horror, house_and_garden, kids_and_family, lgbtq, music, musical, mystery_and_thriller, nature, news, reality, romance, sci_fi, short, soap, special_interest, sports, stand_up, talk_show, travel, variety, war, western.", "schema": { "example": "action,comedy", "type": "string" } }, { "name": "ratings", "required": false, "in": "query", "description": "TV rating values. Enter one or more values as a comma-separated string. The API splits this input by \",\" before forwarding upstream. Allowed values: tv_y, tv_y7, tv_g, tv_pg, tv_14, tv_ma, unrated.", "schema": { "type": "string" } }, { "name": "popcornmeter", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "all", "fresh", "rotten" ] } }, { "name": "tomatometer", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "all", "fresh", "rotten" ] } }, { "name": "affiliates", "required": false, "in": "query", "description": "Affiliate values. Enter one or more values as a comma-separated string. The API splits this input by \",\" before forwarding upstream. Allowed values: fandango_at_home, apple_tv_plus_us, netflix, amazon_prime_video_us, disney_plus_us, max_us, peacock_us, hulu, paramount_plus_us, amc_plus_us, acorn_tv.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "TV series.", "content": { "application/json": { "schema": { "type": "object", "properties": { "affiliates": { "type": "object", "properties": { "id": { "type": "integer", "example": 29288 }, "slug": { "type": "string", "example": "rt-discovery-affiliates" }, "title": { "type": "string", "example": "CM-42969 Fandango at home name and logo" }, "content": { "type": "array", "items": { "type": "object", "properties": { "icon": { "type": "string" }, "name": { "type": "string" }, "value": { "type": "string" }, "id": { "type": "integer" }, "ovdHosts": { "type": "array", "items": { "type": "string" } }, "showFilter": { "type": "boolean" } } } }, "dateStart": { "type": "string", "example": "2026-07-15T13:00:00.000Z" } } }, "filters": { "type": "object", "properties": { "audience": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "value": { "type": "string" }, "sentiment": { "type": "string" }, "certified": { "type": "boolean" } } } }, "critics": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "value": { "type": "string" }, "sentiment": { "type": "string" }, "certified": { "type": "boolean" } } } }, "genres": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "ratings": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "resetFiltersClass": { "type": "string", "example": "" }, "sort": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } } } }, "tv-series": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "audienceScore": { "type": "object", "properties": { "score": { "type": "string", "example": "77" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" } } }, "emsId": { "type": "string" }, "primaryImageUrl": { "type": "string" }, "primaryVideo": { "type": "object", "properties": { "contentType": { "type": "string" }, "publicId": { "type": "string" }, "mpxId": { "type": "string" }, "title": { "type": "string" } } }, "releaseYear": { "type": "string" }, "title": { "type": "string" }, "tomatometerScore": { "type": "object", "properties": { "certified": { "type": "boolean" }, "score": { "type": "string" }, "scoreSentiment": { "type": "string" } } }, "type": { "type": "string" }, "vanity": { "type": "string" } } } }, "pageInfo": { "type": "object", "properties": { "startCursor": { "type": "string", "example": "MA==" }, "endCursor": { "type": "string", "example": "MTc=" }, "hasNextPage": { "type": "boolean", "example": true }, "hasPreviousPage": { "type": "boolean", "example": false } } }, "totalCount": { "type": "integer", "example": 51358 } } } } }, "example": { "affiliates": { "id": 29288, "slug": "rt-discovery-affiliates", "title": "CM-42969 Fandango at home name and logo", "content": [ { "icon": "in-theaters", "name": "Theaters", "value": "theaters" }, { "id": 70906, "icon": "fandango", "name": "Fandango", "value": "fandango", "ovdHosts": [ "1 items" ], "showFilter": true }, { "id": 113064, "icon": "apple-tv-plus-us", "name": "Apple TV", "value": "apple-tv-plus", "ovdHosts": [ "1 items" ], "showFilter": true } ], "dateStart": "2026-07-15T13:00:00.000Z" }, "filters": { "audience": [ { "name": "Hot", "description": "At least 60% of user ratings for a movie or TV show are positive.", "value": "upright", "sentiment": "positive", "certified": false }, { "name": "Stale", "description": "Less than 60% of user ratings for a movie or TV show are positive.", "value": "spilled", "sentiment": "negative", "certified": false } ], "critics": [ { "name": "Fresh", "description": "At least 60% of reviews for a movie or TV show are positive.", "value": "fresh", "sentiment": "positive", "certified": false }, { "name": "Rotten", "description": "Less than 60% of reviews for a movie or TV show are positive.", "value": "rotten", "sentiment": "negative", "certified": false } ], "genres": [ { "name": "Action", "value": "action" }, { "name": "Adventure", "value": "adventure" }, { "name": "Animation", "value": "animation" } ], "ratings": [ { "name": "TV-Y", "value": "tvy" }, { "name": "TV-Y7", "value": "tvy7" }, { "name": "TV-G", "value": "tvg" } ], "resetFiltersClass": "", "sort": [ { "name": "Most popular", "value": "popular" }, { "name": "Newest", "value": "newest" }, { "name": "A → Z", "value": "a_z" } ] }, "tv-series": { "list": [ { "audienceScore": { "keys": [ "score", "scoreSentiment" ] }, "emsId": "b0f2d0bf-77b5-3201-84f4-162290d913a3", "primaryImageUrl": "https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p33155666_b_v12_ad.jpg", "primaryVideo": { "keys": [ "contentType", "publicId", "mpxId", "title" ] }, "releaseYear": "2026", "title": "Tip Toe", "tomatometerScore": { "keys": [ "certified", "score", "scoreSentiment" ] }, "type": "TvSeries", "vanity": "tip_toe" }, { "emsId": "25594950-c352-3cc3-97de-ce319982fd5b", "primaryImageUrl": "https://resizing.flixster.com/mTIyiVboXF8qX5k1OWGHKSpz_0M=/ems.cHJkLWVtcy1hc3NldHMvdHZzZXJpZXMvZGZiMmU1MzItNTBhZi00Y2M5LTk1MTctNDcwNDhlNDI3YThhLmpwZw==", "releaseYear": "2026", "title": "Dragon Striker", "type": "TvSeries", "vanity": "dragon_striker" }, { "emsId": "bb6795e7-10c0-3189-b2e1-fc8f0941ea81", "primaryImageUrl": "https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p32872883_b_v11_aa.jpg", "primaryVideo": { "keys": [ "contentType", "publicId", "mpxId", "title" ] }, "releaseYear": "2026", "title": "Prisoner", "tomatometerScore": { "keys": [ "certified", "score", "scoreSentiment" ] }, "type": "TvSeries", "vanity": "prisoner_2026" } ], "pageInfo": { "startCursor": "MA==", "endCursor": "MTc=", "hasNextPage": true, "hasPreviousPage": false }, "totalCount": 51358 } } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get TV series", "tags": [ "Discovery" ] } }, "/api/discovery/at-home": { "get": { "operationId": "Get at-home titles", "parameters": [ { "name": "after", "required": false, "in": "query", "description": "Pagination cursor returned by the upstream list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "before", "required": false, "in": "query", "description": "Reverse pagination cursor returned by the upstream list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "sort", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "newest", "popularity", "top_box_office", "tomatometer_ascending", "tomatometer_descending", "audience_descending", "audience_ascending", "release_date_newest", "release_date_oldest", "title_az", "title_za" ] } }, { "name": "genres", "required": false, "in": "query", "description": "Genre values. Enter one or more values as a comma-separated string, for example \"action,comedy\". The API splits this input by \",\" before forwarding upstream. Allowed values: action, adventure, animation, anime, biography, comedy, crime, documentary, drama, entertainment, faith_and_spirituality, fantasy, game_show, health_and_wellness, history, holiday, horror, house_and_garden, kids_and_family, lgbtq, music, musical, mystery_and_thriller, nature, news, reality, romance, sci_fi, short, soap, special_interest, sports, stand_up, talk_show, travel, variety, war, western.", "schema": { "example": "action,comedy", "type": "string" } }, { "name": "ratings", "required": false, "in": "query", "description": "Movie rating values. Enter one or more values as a comma-separated string. The API splits this input by \",\" before forwarding upstream. Allowed values: g, pg, pg_13, r, nc_17, unrated.", "schema": { "type": "string" } }, { "name": "audience", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "all", "upright", "spilled", "verified_hot" ] } }, { "name": "critics", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "all", "certified_fresh", "fresh", "rotten" ] } }, { "name": "certified_fresh", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "verified_hot", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "affiliates", "required": false, "in": "query", "description": "Affiliate values. Enter one or more values as a comma-separated string. The API splits this input by \",\" before forwarding upstream. Allowed values: fandango_at_home, apple_tv_plus_us, netflix, amazon_prime_video_us, disney_plus_us, max_us, peacock_us, hulu, paramount_plus_us, amc_plus_us, acorn_tv.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "At-home titles.", "content": { "application/json": { "schema": { "type": "object", "properties": { "affiliates": { "type": "object", "properties": { "id": { "type": "integer", "example": 29288 }, "slug": { "type": "string", "example": "rt-discovery-affiliates" }, "title": { "type": "string", "example": "CM-42969 Fandango at home name and logo" }, "content": { "type": "array", "items": { "type": "object", "properties": { "icon": { "type": "string" }, "name": { "type": "string" }, "value": { "type": "string" }, "id": { "type": "integer" }, "ovdHosts": { "type": "array", "items": { "type": "string" } }, "showFilter": { "type": "boolean" } } } }, "dateStart": { "type": "string", "example": "2026-07-15T13:00:00.000Z" } } }, "filters": { "type": "object", "properties": { "audience": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "value": { "type": "string" }, "sentiment": { "type": "string" }, "certified": { "type": "boolean" } } } }, "critics": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "value": { "type": "string" }, "sentiment": { "type": "string" }, "certified": { "type": "boolean" } } } }, "genres": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "ratings": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "resetFiltersClass": { "type": "string", "example": "" }, "sort": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } } } }, "at-home": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "emsId": { "type": "string" }, "primaryImageUrl": { "type": "string" }, "releaseYear": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" }, "vanity": { "type": "string" }, "audienceScore": { "type": "object", "properties": { "score": { "type": "string", "example": "70" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "certified": { "type": "boolean", "example": false } } }, "primaryVideo": { "type": "object", "properties": { "contentType": { "type": "string" }, "publicId": { "type": "string" }, "mpxId": { "type": "string" }, "title": { "type": "string" } } }, "tomatometerScore": { "type": "object", "properties": { "score": { "type": "string", "example": "80" }, "certified": { "type": "boolean", "example": true }, "scoreSentiment": { "type": "string", "example": "POSITIVE" } } } } } }, "pageInfo": { "type": "object", "properties": { "startCursor": { "type": "string", "example": "MA==" }, "endCursor": { "type": "string", "example": "MTk=" }, "hasNextPage": { "type": "boolean", "example": true }, "hasPreviousPage": { "type": "boolean", "example": false } } }, "totalCount": { "type": "integer", "example": 30 } } } } }, "example": { "affiliates": { "id": 29288, "slug": "rt-discovery-affiliates", "title": "CM-42969 Fandango at home name and logo", "content": [ { "icon": "in-theaters", "name": "Theaters", "value": "theaters" }, { "id": 70906, "icon": "fandango", "name": "Fandango", "value": "fandango", "ovdHosts": [ "1 items" ], "showFilter": true }, { "id": 113064, "icon": "apple-tv-plus-us", "name": "Apple TV", "value": "apple-tv-plus", "ovdHosts": [ "1 items" ], "showFilter": true } ], "dateStart": "2026-07-15T13:00:00.000Z" }, "filters": { "audience": [ { "name": "Verified Hot", "description": "A special distinction awarded to the highest verified theatrical movies.", "value": "verified_hot", "sentiment": "positive", "certified": true }, { "name": "Hot", "description": "At least 60% of user ratings for a movie or TV show are positive.", "value": "upright", "sentiment": "positive", "certified": false }, { "name": "Stale", "description": "Less than 60% of user ratings for a movie or TV show are positive.", "value": "spilled", "sentiment": "negative", "certified": false } ], "critics": [ { "name": "Certified Fresh", "description": "A special distinction awarded to the best reviewed movies and TV shows.", "value": "certified_fresh", "sentiment": "positive", "certified": true }, { "name": "Fresh", "description": "At least 60% of reviews for a movie or TV show are positive.", "value": "fresh", "sentiment": "positive", "certified": false }, { "name": "Rotten", "description": "Less than 60% of reviews for a movie or TV show are positive.", "value": "rotten", "sentiment": "negative", "certified": false } ], "genres": [ { "name": "Action", "value": "action" }, { "name": "Adventure", "value": "adventure" }, { "name": "Animation", "value": "animation" } ], "ratings": [ { "name": "G", "value": "g" }, { "name": "PG", "value": "pg" }, { "name": "PG-13", "value": "pg_13" } ], "resetFiltersClass": "", "sort": [ { "name": "Most popular", "value": "popular" }, { "name": "Newest", "value": "newest" }, { "name": "A → Z", "value": "a_z" } ] }, "at-home": { "list": [ { "emsId": "a466972f-a597-3008-8b51-30a99295db01", "primaryImageUrl": "https://resizing.flixster.com/Sp4xyBYhmk74NCDBJvaduZtU4Fk=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzQwMWFlYThiLTQ4ODEtNGJjMC04MzQ1LWFmNmQ1OTA4NmM2Zi5qcGc=", "releaseYear": "2019", "title": "Outlaw", "type": "Movie", "vanity": "outlaw_2019" }, { "emsId": "c5ff16aa-e5b5-47f3-936f-c47523ed8fcc", "primaryImageUrl": "https://resizing.flixster.com/TcPi1qca_YZ5-AlqvFMHXRESUUc=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzgzMWU0YjMxLWVhYjEtNDc1MC1hMTMwLTUzMGUxNGMzMDUzNC5qcGc=", "releaseYear": "2026", "title": "Bill Maher: The Kennedy Center Mark Twain Prize for American Humor", "type": "Movie", "vanity": "bill_maher_the_kennedy_center_mark_twain_prize_for_american_humor" }, { "audienceScore": { "keys": [ "score", "scoreSentiment", "certified" ] }, "emsId": "0e72bf7d-41ad-434c-af9e-85134db1d77c", "primaryImageUrl": "https://resizing.flixster.com/4W2dp7l4CLYenE1qkQ-HHjqO51w=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzZkYjVlMzFiLTA2NDItNDk4OC1hZGI5LWQyOTY4YTJjZGQ5Mi5qcGc=", "primaryVideo": { "keys": [ "contentType", "publicId", "mpxId", "title" ] }, "releaseYear": "2026", "title": "Disclosure Day", "tomatometerScore": { "keys": [ "score", "certified", "scoreSentiment" ] }, "type": "Movie", "vanity": "disclosure_day" } ], "pageInfo": { "startCursor": "MA==", "endCursor": "MTk=", "hasNextPage": true, "hasPreviousPage": false }, "totalCount": 30 } } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get at-home titles", "tags": [ "Discovery" ] } }, "/api/movies/slug/{slug}": { "get": { "description": "Returns movie details for a Rotten Tomatoes movie slug.", "operationId": "Get movie details by slug", "parameters": [ { "name": "slug", "required": true, "in": "path", "description": "Rotten Tomatoes movie slug from /m/[slug].", "schema": { "type": "string" } }, { "name": "additionalDetails", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "topReviews", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } } ], "responses": { "200": { "description": "Movie details resolved from slug." } }, "summary": "Get movie details by slug", "tags": [ "Content" ] } }, "/api/movies/{emsId}": { "get": { "operationId": "Get movie details", "parameters": [ { "name": "emsId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "additionalDetails", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "topReviews", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } } ], "responses": { "200": { "description": "Movie details.", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "movieDetail": { "type": "object", "properties": { "fandangoMovieId": { "type": "string", "example": "241283" }, "emsMovieId": { "type": "string", "example": "3d8715e6-f32f-4c44-a1c6-ceeec81967c1" }, "rottenTomatoesMovieId": { "type": "string", "example": "900094364" }, "title": { "type": "string", "example": "The Odyssey" }, "description": { "type": "string", "example": "Odysseus, king of Ithaca, embarks on a perilous journey to return home after the Trojan War. Crossing the Mediterrane..." }, "rottenTomatoesUrl": { "type": "string", "example": "https://www.rottentomatoes.com/m/the_odyssey_2026" }, "mediaUrl": { "type": "string", "example": "/m/the_odyssey_2026" }, "vanity": { "type": "string", "example": "the_odyssey_2026" }, "runTimeInMinutes": { "type": "integer", "example": 172 }, "lifecycleWindow": { "type": "object", "properties": { "lifecycle": { "type": "string", "example": "IN_THEATERS" }, "date": { "type": "string", "example": "2026-07-17" } } }, "backgroundImage": { "type": "object", "additionalProperties": true }, "tomatometerScore": { "type": "object", "properties": { "score": { "type": "string", "example": "94" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "certified": { "type": "boolean", "example": true }, "likedCount": { "type": "integer", "example": 407 }, "notLikedCount": { "type": "integer", "example": 26 }, "averageRating": { "type": "string", "example": "8.70" }, "ratingCount": { "type": "integer", "example": 433 }, "reviewCount": { "type": "integer", "example": 433 }, "adjustedScore": { "type": "integer", "example": 122653 }, "topReviewCount": { "type": "integer", "example": 73 }, "dateCertified": { "type": "string", "example": "2026-07-15T16:27:32+0000" }, "consensus": { "type": "string", "example": "Reinvigorating an ancient adventure with majestic sweep and sterling work by its colossal ensemble, Christopher Nolan..." } } }, "audienceConsensus": { "type": "object", "properties": { "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "consensus": { "type": "string", "example": "A cinematic epic fit for the biggest screens, The Odyssey proves with technical precision and unrestrained g..." } } }, "criticsConsensus": { "type": "object", "properties": { "consensus": { "type": "string", "example": "Reinvigorating an ancient adventure with majestic sweep and sterling work by its colossal ensemble, Christopher Nolan..." }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "certified": { "type": "boolean", "example": true } } }, "audienceScore": { "type": "object", "properties": { "scoreType": { "type": "string", "example": "VERIFIED" }, "score": { "type": "string", "example": "97" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "certified": { "type": "boolean", "example": true }, "likedCount": { "type": "integer", "example": 13251 }, "notLikedCount": { "type": "integer", "example": 425 }, "bandedRatingCount": { "type": "string", "example": "10,000+" }, "averageRating": { "type": "string", "example": "4.8" }, "ratingCount": { "type": "integer", "example": 13676 }, "reviewCount": { "type": "integer", "example": 1819 }, "consensus": { "type": "string", "example": "A cinematic epic fit for the biggest screens, The Odyssey proves with technical precision and unrestrained g..." }, "isActivelyModerated": { "type": "boolean", "example": true } } }, "audienceScoreAll": { "type": "object", "properties": { "certified": { "type": "boolean", "example": true }, "averageRating": { "type": "string", "example": "4.6" }, "bandedRatingCount": { "type": "string", "example": "10,000+" }, "likedCount": { "type": "integer", "example": 14350 }, "notLikedCount": { "type": "integer", "example": 1138 }, "reviewCount": { "type": "integer", "example": 3084 }, "scoreType": { "type": "string", "example": "ALL" }, "score": { "type": "string", "example": "93" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "isActivelyModerated": { "type": "boolean", "example": true } } }, "audienceScoreVerified": { "type": "object", "properties": { "certified": { "type": "boolean", "example": true }, "averageRating": { "type": "string", "example": "4.8" }, "bandedRatingCount": { "type": "string", "example": "10,000+" }, "likedCount": { "type": "integer", "example": 13251 }, "notLikedCount": { "type": "integer", "example": 425 }, "reviewCount": { "type": "integer", "example": 1819 }, "scoreType": { "type": "string", "example": "VERIFIED" }, "score": { "type": "string", "example": "97" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "isActivelyModerated": { "type": "boolean", "example": true } } }, "criticsScoreAll": { "type": "object", "properties": { "averageRating": { "type": "string", "example": "8.70" }, "certified": { "type": "boolean", "example": true }, "likedCount": { "type": "integer", "example": 407 }, "notLikedCount": { "type": "integer", "example": 26 }, "ratingCount": { "type": "integer", "example": 433 }, "reviewCount": { "type": "integer", "example": 433 }, "score": { "type": "string", "example": "94" }, "sentiment": { "type": "string", "example": "POSITIVE" } } }, "criticsScoreTop": { "type": "object", "properties": { "averageRating": { "type": "string", "example": "8.90" }, "certified": { "type": "boolean", "example": true }, "likedCount": { "type": "integer", "example": 69 }, "notLikedCount": { "type": "integer", "example": 4 }, "ratingCount": { "type": "integer", "example": 73 }, "reviewCount": { "type": "integer", "example": 73 }, "score": { "type": "string", "example": "95" }, "sentiment": { "type": "string", "example": "POSITIVE" } } }, "ratingsStartDate": { "type": "string", "example": "2026-07-16T21:00:00.000Z" }, "releases": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-07-17" }, "type": { "type": "string", "example": "WIDE" }, "country": { "type": "string", "example": "USA" }, "distributors": { "type": "array", "items": {} } } } }, "productionCompanies": { "type": "array", "items": { "type": "string" } }, "releaseYear": { "type": "string", "example": "2026" }, "posterUri": { "type": "string", "example": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/A6I9ex8FRe7tDW-mI..." }, "primaryImageUrl": { "type": "string", "example": "https://resizing.flixster.com/A6I9ex8FRe7tDW-mI3eP3tx_HmE=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzkyOGVlMzAxLThhN2ItNGYyMy..." }, "primaryVideo": { "type": "object", "properties": { "description": { "type": "string", "example": "" }, "durationInSeconds": { "type": "string", "example": "144.353" }, "mpxId": { "type": "string", "example": "2505286723563" }, "publicId": { "type": "string", "example": "shLelV0Gpaas" }, "publishDate": { "type": "string", "example": "2026-07-01T12:52:35" }, "ratings": { "type": "array", "items": { "type": "object", "additionalProperties": { "type": "string" } } }, "title": { "type": "string", "example": "The Odyssey: Trailer 3" }, "thumbnail": { "type": "object", "properties": { "url": { "type": "string", "example": "https://statcdn.fandango.com/MPX/image/NBCU_Fandango/236/618/thumb_D4194850-04A2-48FB-8AA4-B646D4C3CF18.jpg" } } }, "videoType": { "type": "string", "example": "TRAILER" } } }, "topCredits": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "mediaUrl": { "type": "string" }, "vanity": { "type": "string" }, "posterUri": { "type": "string" }, "primaryImageUrl": { "type": "string" }, "creditedName": { "type": "string" }, "credits": { "type": "array", "items": {} }, "characterNames": { "type": "array", "items": {} } } } }, "assets": { "type": "object", "properties": { "videos": { "type": "object", "properties": { "all": { "type": "array", "items": {} } } }, "images": { "type": "object", "properties": { "titleTreatment": { "type": "object", "additionalProperties": { "type": "array", "items": {} } }, "all": { "type": "array", "items": {} } } } } }, "fandangoUrl": { "type": "string", "example": "https://www.fandango.com/the-odyssey-2026-241283/movie-overview" }, "genres": { "type": "array", "items": { "type": "string" } }, "hasShowtimes": { "type": "boolean", "example": true }, "ratings": { "type": "array", "items": { "type": "object", "properties": { "ratingsBody": { "type": "string", "example": "Motion Picture Association" }, "code": { "type": "string", "example": "R" } } } }, "soundMixes": { "type": "array", "items": { "type": "string", "example": "Dolby Digital" } }, "originalAudioLanguage": { "type": "string", "example": "English" }, "whereToWatch": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "Fandango" }, "url": { "type": "string", "example": "https://www.fandango.com/the-odyssey-2026-241283/movie-overview" }, "id": { "type": "string", "example": "fandango" }, "viewingOptions": { "type": "object", "additionalProperties": { "type": "string", "example": "buy tickets" } } } } }, "cta": { "type": "object", "properties": { "buttonText": { "type": "string", "example": "Buy Tickets" }, "windowText": { "type": "string", "example": "Now in Theaters" }, "name": { "type": "string", "example": "Fandango" }, "id": { "type": "string", "example": "" }, "lifecycleDate": { "type": "string", "example": "2026-07-17" }, "url": { "type": "string", "example": "https://www.fandango.com/the-odyssey-2026-241283/movie-overview" } } }, "recommendation": { "type": "array", "items": { "type": "object", "properties": { "audienceScore": { "type": "object", "additionalProperties": {} }, "emsId": { "type": "string" }, "posterUri": { "type": "string" }, "primaryImageUrl": { "type": "string" }, "primaryVideo": { "type": "object", "additionalProperties": { "type": "string" } }, "releaseYear": { "type": "string" }, "title": { "type": "string" }, "tomatometerScore": { "type": "object", "additionalProperties": {} }, "type": { "type": "string" }, "mediaUrl": { "type": "string" }, "vanity": { "type": "string" } } } }, "newsAndArticles": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "link": { "type": "string" }, "featured_image": { "type": "object", "additionalProperties": {} }, "title": { "type": "object", "additionalProperties": { "type": "string" } } } } } } }, "criticReviewHref": { "type": "string", "example": "/critics/self-submission/movie/3d8715e6-f32f-4c44-a1c6-ceeec81967c1" }, "hasAudienceAll": { "type": "boolean", "example": true }, "hasAudienceVerified": { "type": "boolean", "example": true }, "hasCriticsAll": { "type": "boolean", "example": true }, "hasCriticsTop": { "type": "boolean", "example": true }, "releaseDate": { "type": "string", "example": "2026-07-17" }, "audienceReviews": { "type": "array", "items": { "type": "object", "properties": { "ratingId": { "type": "string" }, "rating": { "type": "string" }, "review": { "type": "string" }, "displayName": { "type": "string" }, "initials": { "type": "string" }, "isVerified": { "type": "boolean" }, "isSuperReviewer": { "type": "boolean" }, "hasSpoilers": { "type": "boolean" }, "hasProfanity": { "type": "boolean" }, "createDate": { "type": "string" }, "updateDate": { "type": "string" }, "user": { "type": "object", "properties": { "encryptedUserId": { "type": "string" }, "realm": { "type": "string" }, "initials": { "type": "string" }, "displayName": { "type": "string" } } }, "reactionSummary": { "type": "object", "properties": { "reactions": { "type": "array", "items": {} }, "totalCount": { "type": "integer" }, "updateDateTime": { "type": "string" }, "activityType": { "type": "string" }, "activityId": { "type": "string" }, "postType": { "type": "string" } } } } } }, "criticReviews": { "type": "array", "items": { "type": "object", "properties": { "reviewId": { "type": "string" }, "scoreSentiment": { "type": "string" }, "originalScore": { "type": "string" }, "isTopReview": { "type": "boolean" }, "publicationReviewUrl": { "type": "string" }, "createDate": { "type": "string" }, "updateDate": { "type": "string" }, "reviewQuote": { "type": "string" }, "language": { "type": "string" }, "critic": { "type": "object", "properties": { "displayName": { "type": "string" }, "initials": { "type": "string" }, "rottenTomatoesUrl": { "type": "string" }, "isTopCritic": { "type": "boolean" }, "tomatometerApproved": { "type": "boolean" }, "vanity": { "type": "string" }, "encryptedCriticId": { "type": "string" }, "displayImageUrl": { "type": "string" }, "criticsGroups": { "type": "array", "items": {} }, "user": { "type": "object", "additionalProperties": { "type": "string" } } } }, "publication": { "type": "object", "properties": { "name": { "type": "string" }, "editorialUrl": { "type": "string" }, "isTopPublication": { "type": "boolean" }, "tomatometerApproved": { "type": "boolean" }, "encryptedPublicationId": { "type": "string" }, "publicationId": { "type": "string" }, "publicationImageUrl": { "type": "string" } } }, "reactionSummary": { "type": "object", "properties": { "reactions": { "type": "array", "items": {} }, "totalCount": { "type": "integer" }, "activityType": { "type": "string" }, "activityId": { "type": "string" }, "postType": { "type": "string" }, "updateDateTime": { "type": "string" } } } } } }, "videoOverlayImage": { "type": "string", "example": "https://statcdn.fandango.com/MPX/image/NBCU_Fandango/236/618/thumb_D4194850-04A2-48FB-8AA4-B646D4C3CF18.jpg" } } } }, "example": [ { "movieDetail": { "fandangoMovieId": "241283", "emsMovieId": "3d8715e6-f32f-4c44-a1c6-ceeec81967c1", "rottenTomatoesMovieId": "900094364", "title": "The Odyssey", "description": "Odysseus, king of Ithaca, embarks on a perilous journey to return home after the Trojan War. Crossing the Mediterranean Sea with his fellow soldiers, they soon find themselves battling not only the elements, but an array of deadly obstacles and mythical creatures along the way.", "rottenTomatoesUrl": "https://www.rottentomatoes.com/m/the_odyssey_2026", "mediaUrl": "/m/the_odyssey_2026", "vanity": "the_odyssey_2026", "runTimeInMinutes": 172, "lifecycleWindow": { "lifecycle": "IN_THEATERS", "date": "2026-07-17" }, "backgroundImage": {}, "tomatometerScore": { "score": "94", "scoreSentiment": "POSITIVE", "certified": true, "likedCount": 407, "notLikedCount": 26, "averageRating": "8.70", "ratingCount": 433, "reviewCount": 433, "adjustedScore": 122653, "topReviewCount": 73, "dateCertified": "2026-07-15T16:27:32+0000", "consensus": "Reinvigorating an ancient adventure with majestic sweep and sterling work by its colossal ensemble, Christopher Nolan's The Odyssey imbues myth with primal human feeling." }, "audienceConsensus": { "scoreSentiment": "POSITIVE", "consensus": "A cinematic epic fit for the biggest screens, The Odyssey proves with technical precision and unrestrained grandeur that there’s no filmmaker quite like Christopher Nolan to steer Odysseus’ voyage home." }, "criticsConsensus": { "consensus": "Reinvigorating an ancient adventure with majestic sweep and sterling work by its colossal ensemble, Christopher Nolan's The Odyssey imbues myth with primal human feeling.", "scoreSentiment": "POSITIVE", "certified": true }, "audienceScore": { "scoreType": "VERIFIED", "score": "97", "scoreSentiment": "POSITIVE", "certified": true, "likedCount": 13251, "notLikedCount": 425, "bandedRatingCount": "10,000+", "averageRating": "4.8", "ratingCount": 13676, "reviewCount": 1819, "consensus": "A cinematic epic fit for the biggest screens, The Odyssey proves with technical precision and unrestrained grandeur that there’s no filmmaker quite like Christopher Nolan to steer Odysseus’ voyage home.", "isActivelyModerated": true }, "audienceScoreAll": { "certified": true, "averageRating": "4.6", "bandedRatingCount": "10,000+", "likedCount": 14350, "notLikedCount": 1138, "reviewCount": 3084, "scoreType": "ALL", "score": "93", "scoreSentiment": "POSITIVE", "isActivelyModerated": true }, "audienceScoreVerified": { "certified": true, "averageRating": "4.8", "bandedRatingCount": "10,000+", "likedCount": 13251, "notLikedCount": 425, "reviewCount": 1819, "scoreType": "VERIFIED", "score": "97", "scoreSentiment": "POSITIVE", "isActivelyModerated": true }, "criticsScoreAll": { "averageRating": "8.70", "certified": true, "likedCount": 407, "notLikedCount": 26, "ratingCount": 433, "reviewCount": 433, "score": "94", "sentiment": "POSITIVE" }, "criticsScoreTop": { "averageRating": "8.90", "certified": true, "likedCount": 69, "notLikedCount": 4, "ratingCount": 73, "reviewCount": 73, "score": "95", "sentiment": "POSITIVE" }, "ratingsStartDate": "2026-07-16T21:00:00.000Z", "releases": [ { "keys": [ "date", "type", "country", "distributors" ] } ], "productionCompanies": [ "Syncopy", "Universal Pictures" ], "releaseYear": "2026", "posterUri": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/A6I9ex8FRe7tDW-mI3eP3tx_HmE=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzkyOGVlMzAxLThhN2ItNGYyMy04NzdjLTYyNTEyMDRmYTQzOS5qcGc=", "primaryImageUrl": "https://resizing.flixster.com/A6I9ex8FRe7tDW-mI3eP3tx_HmE=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzkyOGVlMzAxLThhN2ItNGYyMy04NzdjLTYyNTEyMDRmYTQzOS5qcGc=", "primaryVideo": { "description": "", "durationInSeconds": "144.353", "mpxId": "2505286723563", "publicId": "shLelV0Gpaas", "publishDate": "2026-07-01T12:52:35", "ratings": [ "2 items" ], "title": "The Odyssey: Trailer 3", "thumbnail": { "keys": [ "url" ] }, "videoType": "TRAILER" }, "topCredits": [ { "keys": [ "id", "mediaUrl", "vanity", "posterUri", "primaryImageUrl", "creditedName", "credits" ] }, { "keys": [ "id", "mediaUrl", "vanity", "posterUri", "primaryImageUrl", "creditedName", "credits", "characterNames" ] }, { "keys": [ "id", "mediaUrl", "vanity", "posterUri", "primaryImageUrl", "creditedName", "credits", "characterNames" ] } ], "assets": { "videos": { "keys": [ "all" ] }, "images": { "keys": [ "titleTreatment", "all" ] } }, "fandangoUrl": "https://www.fandango.com/the-odyssey-2026-241283/movie-overview", "genres": [ "Adventure", "Action", "Fantasy" ], "hasShowtimes": true, "ratings": [ { "keys": [ "ratingsBody", "code" ] } ], "soundMixes": [ "Dolby Digital" ], "originalAudioLanguage": "English", "whereToWatch": [ { "keys": [ "name", "url", "id", "viewingOptions" ] } ], "cta": { "buttonText": "Buy Tickets", "windowText": "Now in Theaters", "name": "Fandango", "id": "", "lifecycleDate": "2026-07-17", "url": "https://www.fandango.com/the-odyssey-2026-241283/movie-overview" }, "recommendation": [ { "keys": [ "audienceScore", "emsId", "posterUri", "primaryImageUrl", "primaryVideo", "releaseYear", "title", "tomatometerScore", "type", "mediaUrl", "vanity" ] }, { "keys": [ "audienceScore", "emsId", "posterUri", "primaryImageUrl", "primaryVideo", "releaseYear", "title", "tomatometerScore", "type", "mediaUrl", "vanity" ] }, { "keys": [ "audienceScore", "emsId", "posterUri", "primaryImageUrl", "primaryVideo", "releaseYear", "title", "tomatometerScore", "type", "mediaUrl", "vanity" ] } ], "newsAndArticles": [ { "keys": [ "id", "link", "featured_image", "title" ] }, { "keys": [ "id", "link", "featured_image", "title" ] }, { "keys": [ "id", "link", "featured_image", "title" ] } ] }, "criticReviewHref": "/critics/self-submission/movie/3d8715e6-f32f-4c44-a1c6-ceeec81967c1", "hasAudienceAll": true, "hasAudienceVerified": true, "hasCriticsAll": true, "hasCriticsTop": true, "releaseDate": "2026-07-17", "audienceReviews": [ { "ratingId": "c977803b-601a-4cc9-a78b-d5cdde777cd6", "rating": "STAR_5", "review": "Nolan at his best is actually a must see. Especially if you get the opportunity to see it in 70mm. Even if yoy can’t see it in 70mm I still highly recommend seeing this film.", "displayName": "James", "initials": "J", "isVerified": true, "isSuperReviewer": false, "hasSpoilers": false, "hasProfanity": false, "createDate": "2026-07-24T00:17:00.989Z", "updateDate": "2026-07-24T00:19:46.516Z", "user": { "keys": [ "encryptedUserId", "realm", "initials", "displayName" ] }, "reactionSummary": { "keys": [ "reactions", "totalCount", "updateDateTime", "activityType", "activityId", "postType" ] } }, { "ratingId": "3feeef35-164a-45b7-b8cf-c20f5610692a", "rating": "STAR_2", "review": "too loud and gratuitous gore in a number of scenes.", "displayName": "Joseph C", "initials": "JC", "isVerified": true, "isSuperReviewer": false, "hasSpoilers": false, "hasProfanity": false, "createDate": "2026-07-24T00:11:06.866Z", "updateDate": "2026-07-24T00:14:19.570Z", "user": { "keys": [ "encryptedUserId", "realm", "initials", "displayName" ] }, "reactionSummary": { "keys": [ "reactions", "totalCount", "updateDateTime", "activityType", "activityId", "postType" ] } }, { "ratingId": "d678d734-3402-42dd-987b-734aaf34cf0e", "rating": "STAR_5", "review": "Amazon movie. Cant wait to see it again!", "displayName": "B Johnson", "initials": "BJ", "isVerified": true, "isSuperReviewer": false, "hasSpoilers": false, "hasProfanity": false, "createDate": "2026-07-24T00:01:43.297Z", "updateDate": "2026-07-24T00:03:00.240Z", "user": { "keys": [ "encryptedUserId", "realm", "initials", "displayName" ] }, "reactionSummary": { "keys": [ "reactions", "totalCount", "updateDateTime", "activityType", "activityId", "postType" ] } } ], "criticReviews": [ { "reviewId": "103145713", "scoreSentiment": "POSITIVE", "originalScore": "3.5/5", "isTopReview": true, "publicationReviewUrl": "https://www.filmspotting.net/episodes-archive/2026/7/23-odyssey", "createDate": "2026-07-24T14:31:09.000Z", "updateDate": "2026-07-24T14:31:09.000Z", "reviewQuote": "Perhaps only The Odyssey could offer Nolan the canvas epic enough for all his obsessions.", "language": "English", "critic": { "keys": [ "displayName", "initials", "rottenTomatoesUrl", "isTopCritic", "tomatometerApproved", "vanity", "encryptedCriticId", "displayImageUrl", "criticsGroups", "user" ] }, "publication": { "keys": [ "name", "editorialUrl", "isTopPublication", "tomatometerApproved", "encryptedPublicationId", "publicationId" ] }, "reactionSummary": { "keys": [ "reactions", "totalCount", "activityType", "activityId", "postType" ] } }, { "reviewId": "103145075", "scoreSentiment": "POSITIVE", "originalScore": "4.5/5", "isTopReview": true, "publicationReviewUrl": "https://thereveal.film/in-review-the-odyssey/", "createDate": "2026-07-21T22:07:32.000Z", "updateDate": "2026-07-21T22:07:32.000Z", "reviewQuote": "Who else but Nolan could even conceive of getting a full-scale production of The Odyssey off the ground? Or, more pertinently, who else could have invested it with this much meaning, as a continuum of a brilliant career? ", "language": "English", "critic": { "keys": [ "displayName", "initials", "rottenTomatoesUrl", "isTopCritic", "tomatometerApproved", "vanity", "encryptedCriticId", "displayImageUrl", "criticsGroups", "user" ] }, "publication": { "keys": [ "name", "editorialUrl", "isTopPublication", "tomatometerApproved", "encryptedPublicationId", "publicationId" ] }, "reactionSummary": { "keys": [ "reactions", "totalCount", "updateDateTime", "activityType", "activityId", "postType" ] } }, { "reviewId": "103144977", "scoreSentiment": "POSITIVE", "originalScore": "4/5", "isTopReview": true, "publicationReviewUrl": "https://www.aarp.org/entertainment/television/what-to-watch-best-new-movies-shows-streaming.html", "createDate": "2026-07-21T17:34:17.000Z", "updateDate": "2026-07-22T14:36:16.000Z", "reviewQuote": "A spectacular movie crying for Oscar but nonetheless lacking the original’s poetry. ", "language": "English", "critic": { "keys": [ "displayName", "initials", "rottenTomatoesUrl", "isTopCritic", "tomatometerApproved", "vanity", "encryptedCriticId", "displayImageUrl", "criticsGroups" ] }, "publication": { "keys": [ "name", "editorialUrl", "isTopPublication", "tomatometerApproved", "publicationImageUrl", "encryptedPublicationId", "publicationId" ] }, "reactionSummary": { "keys": [ "reactions", "totalCount", "updateDateTime", "activityType", "activityId", "postType" ] } } ], "videoOverlayImage": "https://statcdn.fandango.com/MPX/image/NBCU_Fandango/236/618/thumb_D4194850-04A2-48FB-8AA4-B646D4C3CF18.jpg" } ] } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get movie details", "tags": [ "Content" ] } }, "/api/movies/slug/{slug}/reviews": { "get": { "description": "Returns movie reviews for a Rotten Tomatoes movie slug.", "operationId": "Get movie reviews by slug", "parameters": [ { "name": "slug", "required": true, "in": "path", "description": "Rotten Tomatoes movie slug from /m/[slug].", "schema": { "type": "string" } }, { "name": "after", "required": false, "in": "query", "description": "Pagination cursor returned by the upstream reviews list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "before", "required": false, "in": "query", "description": "Reverse pagination cursor returned by the upstream reviews list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "type", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "critic", "audience" ] } }, { "name": "sort", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "newest", "oldest" ] } }, { "name": "topOnly", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "verified", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "pageCount", "required": false, "in": "query", "description": "Page count value forwarded exactly when provided. No default is injected.", "schema": { "example": "20", "type": "string" } } ], "responses": { "200": { "description": "Movie reviews resolved from slug." } }, "summary": "Get movie reviews by slug", "tags": [ "Content" ] } }, "/api/movies/{emsId}/reviews": { "get": { "operationId": "Get movie reviews", "parameters": [ { "name": "emsId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "after", "required": false, "in": "query", "description": "Pagination cursor returned by the upstream reviews list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "before", "required": false, "in": "query", "description": "Reverse pagination cursor returned by the upstream reviews list. Forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "type", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "critic", "audience" ] } }, { "name": "sort", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "newest", "oldest" ] } }, { "name": "topOnly", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "verified", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "pageCount", "required": false, "in": "query", "description": "Page count value forwarded exactly when provided. No default is injected.", "schema": { "example": "20", "type": "string" } } ], "responses": { "200": { "description": "Movie reviews.", "content": { "application/json": { "schema": { "type": "object", "properties": { "reviews": { "type": "array", "items": { "type": "object", "properties": { "reviewId": { "type": "string" }, "scoreSentiment": { "type": "string" }, "originalScore": { "type": "string" }, "isTopReview": { "type": "boolean" }, "publicationReviewUrl": { "type": "string" }, "createDate": { "type": "string" }, "updateDate": { "type": "string" }, "reviewQuote": { "type": "string" }, "language": { "type": "string" }, "critic": { "type": "object", "properties": { "displayName": { "type": "string" }, "initials": { "type": "string" }, "rottenTomatoesUrl": { "type": "string" }, "isTopCritic": { "type": "boolean" }, "tomatometerApproved": { "type": "boolean" }, "vanity": { "type": "string" }, "encryptedCriticId": { "type": "string" }, "displayImageUrl": { "type": "string" }, "criticsGroups": { "type": "array", "items": {} } } }, "publication": { "type": "object", "properties": { "name": { "type": "string" }, "editorialUrl": { "type": "string" }, "isTopPublication": { "type": "boolean" }, "tomatometerApproved": { "type": "boolean" }, "encryptedPublicationId": { "type": "string" }, "publicationId": { "type": "string" }, "publicationImageUrl": { "type": "string" } } }, "reactionSummary": { "type": "object", "properties": { "reactions": { "type": "array", "items": { "type": "object", "additionalProperties": {} } }, "totalCount": { "type": "integer" }, "activityType": { "type": "string" }, "activityId": { "type": "string" }, "postType": { "type": "string" }, "updateDateTime": { "type": "string" } } } } } }, "pageInfo": { "type": "object", "properties": { "hasNextPage": { "type": "boolean", "example": true }, "hasPreviousPage": { "type": "boolean", "example": false }, "endCursor": { "type": "string", "example": "MQ==" } } } } }, "example": { "reviews": [ { "reviewId": "103145713", "scoreSentiment": "POSITIVE", "originalScore": "3.5/5", "isTopReview": true, "publicationReviewUrl": "https://www.filmspotting.net/episodes-archive/2026/7/23-odyssey", "createDate": "2026-07-24T14:31:09.000Z", "updateDate": "2026-07-24T14:31:09.000Z", "reviewQuote": "Perhaps only The Odyssey could offer Nolan the canvas epic enough for all his obsessions.", "language": "English", "critic": { "displayName": "Adam Kempenaar", "initials": "AK", "rottenTomatoesUrl": "https://www.rottentomatoes.com/critic/adam-kempenaar", "isTopCritic": false, "tomatometerApproved": true, "vanity": "adam-kempenaar", "encryptedCriticId": "Vy2wobZW", "displayImageUrl": "https://resizing.flixster.com/yeS_FOGyLW-OdxS_RwM5Ik5Thp4=/128x128/v1.YzsxMDAwMDAyODU1O3A7MjA3MDk7MjA0ODsyMDA7MjAw", "criticsGroups": [] }, "publication": { "name": "Filmspotting", "editorialUrl": "http://www.filmspotting.net", "isTopPublication": true, "tomatometerApproved": true, "encryptedPublicationId": "jlOdB4y0", "publicationId": "1967" }, "reactionSummary": { "reactions": [ "6 items" ], "totalCount": 0, "activityType": "critic", "activityId": "103145713", "postType": "criticReview" } }, { "reviewId": "103145678", "scoreSentiment": "POSITIVE", "originalScore": "5/5", "isTopReview": false, "publicationReviewUrl": "https://www.lamusica.com/shows/el-barrio-94/episodes/6a46e2c4af07e258f97b29e8", "createDate": "2026-07-24T12:20:41.000Z", "updateDate": "2026-07-24T12:20:41.000Z", "reviewQuote": "The true meaning of cinematic experience; Nolan brings the ancestral story as a reflection of humanity, trauma, loyalty, and the end of civilization if we don't learn and understand the mistakes of the past. [Full review in Spanish]", "language": "Spanish", "critic": { "displayName": "Jorge Rivera Rubio", "initials": "JR", "rottenTomatoesUrl": "https://www.rottentomatoes.com/critic/jorge-rivera-rubio", "isTopCritic": false, "tomatometerApproved": true, "vanity": "jorge-rivera-rubio", "encryptedCriticId": "4rwPQalA", "displayImageUrl": "https://resizing.flixster.com/4BaxKo5qgfg37EddaYZ9m9nGewg=/128x128/v1.YzsxMDAwMDAzOTI2O2o7MjA3MDk7MjA0ODsxMDc0Ozk2NA", "criticsGroups": [] }, "publication": { "name": "El Barrio de la Nueva 94FM", "isTopPublication": false, "tomatometerApproved": false, "encryptedPublicationId": "ynwvgKeZ", "publicationId": "100011673" }, "reactionSummary": { "reactions": [ "6 items" ], "totalCount": 0, "activityType": "critic", "activityId": "103145678", "postType": "criticReview" } }, { "reviewId": "103145568", "scoreSentiment": "POSITIVE", "isTopReview": false, "publicationReviewUrl": "https://www.forbes.com/sites/erikkain/2026/07/17/the-odyssey-christopher-nolan-matt-damon-movie-review/", "createDate": "2026-07-23T20:56:55.000Z", "updateDate": "2026-07-23T20:56:55.000Z", "reviewQuote": "Nolan’s vision is distinct, at once grounded and nightmarish, with some big changes but the spirit of the story intact. I found the ending surprisingly poignant. It is not the "big historical epic" of the past, but something new entirely.", "language": "English", "critic": { "displayName": "Erik Kain", "initials": "EK", "rottenTomatoesUrl": "https://www.rottentomatoes.com/critic/erik-kain", "isTopCritic": false, "tomatometerApproved": true, "vanity": "erik-kain", "encryptedCriticId": "pZ6wOJre", "displayImageUrl": "https://resizing.flixster.com/Kona1Zm0faeIyzabSy6TYnIIW1o=/128x128/v1.YzsxMDAwMDAzMjkyO3A7MjA3MDk7MjA0ODs4MDA7ODAw", "criticsGroups": [] }, "publication": { "name": "Forbes", "editorialUrl": "http://www.forbes.com/", "isTopPublication": false, "tomatometerApproved": false, "publicationImageUrl": "https://resizing.flixster.com/nOgJFCMVIJyLGgtN6NwGVc1yv94=/256x256/v1.YzsxMDAwMDAzNjM2O2o7MjA3MDk7MjA0ODs0ODAwOzI3MDA", "encryptedPublicationId": "Vy2qwJlW", "publicationId": "2233" }, "reactionSummary": { "reactions": [ "6 items" ], "totalCount": 1, "updateDateTime": "2026-07-24T02:58:01.922Z", "activityType": "critic", "activityId": "103145568", "postType": "criticReview" } } ], "pageInfo": { "hasNextPage": true, "hasPreviousPage": false, "endCursor": "MQ==" } } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get movie reviews", "tags": [ "Content" ] } }, "/api/tv/series/slug/{slug}": { "get": { "description": "Returns TV series details for a Rotten Tomatoes TV slug.", "operationId": "Get TV series details by slug", "parameters": [ { "name": "slug", "required": true, "in": "path", "description": "Rotten Tomatoes TV slug from /tv/[slug].", "schema": { "type": "string" } }, { "name": "additionalDetails", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } } ], "responses": { "200": { "description": "TV series details resolved from slug." } }, "summary": "Get TV series details by slug", "tags": [ "Content" ] } }, "/api/tv/series/{emsId}": { "get": { "operationId": "Get TV series details", "parameters": [ { "name": "emsId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "additionalDetails", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } } ], "responses": { "200": { "description": "TV series details.", "content": { "application/json": { "schema": { "type": "object", "properties": { "tvSeries": { "type": "array", "items": { "type": "object", "properties": { "recommendation": { "type": "array", "items": {} }, "newsAndArticles": { "type": "array", "items": {} } } } } } }, "example": { "tvSeries": [ { "recommendation": [], "newsAndArticles": [] } ] } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get TV series details", "tags": [ "Content" ] } }, "/api/tv/seasons/slug/{slug}/user-rating": { "get": { "description": "Returns TV season user rating for a Rotten Tomatoes TV slug.", "operationId": "Get TV season user rating by slug", "parameters": [ { "name": "slug", "required": true, "in": "path", "description": "Rotten Tomatoes TV season slug path from /tv/[series-slug]/[season-slug].", "schema": { "type": "string" } } ], "responses": { "200": { "description": "TV season user rating resolved from slug." } }, "summary": "Get TV season user rating by slug", "tags": [ "Content" ] } }, "/api/tv/seasons/slug/{slug}": { "get": { "description": "Returns TV season details for a Rotten Tomatoes TV slug.", "operationId": "Get TV season details by slug", "parameters": [ { "name": "additionalDetails", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "topReviews", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "slug", "required": true, "in": "path", "description": "Rotten Tomatoes TV season slug path from /tv/[series-slug]/[season-slug].", "schema": { "type": "string" } } ], "responses": { "200": { "description": "TV season details resolved from slug." } }, "summary": "Get TV season details by slug", "tags": [ "Content" ] } }, "/api/tv/seasons/{seasonEmsId}": { "get": { "operationId": "Get TV season details", "parameters": [ { "name": "seasonEmsId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "additionalDetails", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "topReviews", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "true", "false" ] } } ], "responses": { "200": { "description": "TV season details." } }, "summary": "Get TV season details", "tags": [ "Content" ] } }, "/api/tv/seasons/{seasonEmsId}/user-rating": { "get": { "operationId": "Get TV season user rating", "parameters": [ { "name": "seasonEmsId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "TV season user rating." } }, "summary": "Get TV season user rating", "tags": [ "Content" ] } }, "/api/users/{encryptedUserId}/aggregated-profile": { "get": { "operationId": "Get user aggregated profile", "parameters": [ { "name": "encryptedUserId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "User aggregated profile.", "content": { "application/json": { "schema": { "type": "object", "properties": { "profileType": { "type": "string", "example": "user" }, "profile": { "type": "object", "properties": { "profileHandle": { "type": "string", "example": "RT75169145" }, "profileImage": { "nullable": true }, "background": { "nullable": true }, "name": { "type": "string", "example": "Jakrapat S" }, "initials": { "type": "string", "example": "JS" }, "displayName": { "type": "string", "example": "Jakrapat S" }, "hasDefaultValues": { "type": "boolean", "example": true }, "isOfficialUser": { "type": "boolean", "example": false } } }, "followSummary": { "type": "object", "properties": { "followingCount": { "type": "integer", "example": 0 }, "followersCount": { "type": "integer", "example": 0 }, "isFollowing": { "type": "boolean", "example": false } } }, "lists": { "type": "object", "properties": { "data": { "type": "array", "items": {} }, "pageInfo": { "type": "object", "properties": { "next": { "nullable": true }, "previous": { "nullable": true } } }, "totalCount": { "type": "integer", "example": 0 } } } } }, "example": { "profileType": "user", "profile": { "profileHandle": "RT75169145", "profileImage": null, "background": null, "name": "Jakrapat S", "initials": "JS", "displayName": "Jakrapat S", "hasDefaultValues": true, "isOfficialUser": false }, "followSummary": { "followingCount": 0, "followersCount": 0, "isFollowing": false }, "lists": { "data": [], "pageInfo": { "next": null, "previous": null }, "totalCount": 0 } } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get user aggregated profile", "tags": [ "Users" ] } }, "/api/users/{encryptedUserId}/reviews": { "get": { "operationId": "Get user reviews", "parameters": [ { "name": "encryptedUserId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "limit", "required": false, "in": "query", "description": "Limit value forwarded exactly when provided. No default is injected.", "schema": { "example": "20", "type": "string" } } ], "responses": { "200": { "description": "User reviews.", "content": { "application/json": { "schema": { "type": "object", "properties": { "reviews": { "type": "array", "items": { "type": "object", "properties": { "ratingId": { "type": "string" }, "rating": { "type": "string" }, "review": { "type": "string", "example": "Grand and spectacular, completely living up to its reputation. Everything was perfect. Just seeing the visuals and he..." }, "displayName": { "type": "string" }, "initials": { "type": "string" }, "isVerified": { "type": "boolean" }, "isSuperReviewer": { "type": "boolean" }, "hasSpoilers": { "type": "boolean" }, "hasProfanity": { "type": "boolean" }, "createDate": { "type": "string" }, "updateDate": { "type": "string" }, "reviewState": { "type": "string" }, "reviewStateUpdateDate": { "type": "string", "example": "2026-07-20T17:23:27.617Z" }, "media": { "type": "object", "properties": { "audienceScore": { "type": "object", "properties": { "scoreType": { "type": "string" }, "score": { "type": "string" }, "scoreSentiment": { "type": "string" }, "certified": { "type": "boolean" }, "isActivelyModerated": { "type": "boolean" } } }, "emsId": { "type": "string" }, "mediaType": { "type": "string" }, "primaryImageUrl": { "type": "string" }, "primaryVideo": { "type": "object", "properties": { "mpxId": { "type": "string" }, "publicId": { "type": "string" } } }, "title": { "type": "string" }, "tomatometerScore": { "type": "object", "properties": { "certified": { "type": "boolean" }, "score": { "type": "string" }, "scoreSentiment": { "type": "string" } } }, "vanity": { "type": "string" }, "posterUri": { "type": "string" } } }, "user": { "type": "object", "properties": { "encryptedUserId": { "type": "string" }, "realm": { "type": "string" }, "familyName": { "type": "string" }, "givenName": { "type": "string" }, "fullName": { "type": "string" }, "profileImage": { "nullable": true }, "profileHandle": { "type": "string" }, "background": { "nullable": true }, "initials": { "type": "string" }, "displayName": { "type": "string" }, "isOfficialUser": { "type": "boolean" } } }, "reactionSummary": { "type": "object", "properties": { "reactions": { "type": "array", "items": { "type": "object", "additionalProperties": {} } }, "totalCount": { "type": "integer" }, "activityType": { "type": "string" }, "activityId": { "type": "string" }, "postType": { "type": "string" } } }, "mediaType": { "type": "string" }, "reviewType": { "type": "string" } } } }, "pageInfo": { "type": "object", "properties": { "hasNextPage": { "type": "boolean", "example": false }, "hasPreviousPage": { "type": "boolean", "example": false }, "endCursor": { "nullable": true }, "startCursor": { "nullable": true } } }, "meta": { "type": "object", "properties": { "movieCount": { "type": "integer", "example": 2 }, "tvCount": { "type": "integer", "example": 0 }, "totalReturned": { "type": "integer", "example": 2 }, "movieCountInPage": { "type": "integer", "example": 2 }, "tvCountInPage": { "type": "integer", "example": 0 } } } } }, "example": { "reviews": [ { "ratingId": "002ea075-bef0-4837-8fe1-0c7597fb454e", "rating": "STAR_5", "review": "Grand and spectacular, completely living up to its reputation. Everything was perfect. Just seeing the visuals and hearing the sound made it totally worth it.", "displayName": "Jakrapat S", "initials": "JS", "isVerified": false, "isSuperReviewer": false, "hasSpoilers": false, "hasProfanity": false, "createDate": "2026-07-20T17:23:27.617Z", "updateDate": "2026-07-20T17:39:27.570Z", "reviewState": "PUBLISHED", "reviewStateUpdateDate": "2026-07-20T17:23:27.617Z", "media": { "audienceScore": { "keys": [ "scoreType", "score", "scoreSentiment", "certified", "isActivelyModerated" ] }, "emsId": "3d8715e6-f32f-4c44-a1c6-ceeec81967c1", "mediaType": "movie", "primaryImageUrl": "https://resizing.flixster.com/A6I9ex8FRe7tDW-mI3eP3tx_HmE=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzkyOGVlMzAxLThhN2ItNGYyMy04NzdjLTYyNTEyMDRmYTQzOS5qcGc=", "primaryVideo": { "keys": [ "mpxId", "publicId" ] }, "title": "The Odyssey", "tomatometerScore": { "keys": [ "certified", "score", "scoreSentiment" ] }, "vanity": "the_odyssey_2026", "posterUri": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/A6I9ex8FRe7tDW-mI3eP3tx_HmE=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzkyOGVlMzAxLThhN2ItNGYyMy04NzdjLTYyNTEyMDRmYTQzOS5qcGc=" }, "user": { "encryptedUserId": "EWkfKEsE3toDCYzfL8Hj7IVKIaacERSo0FnXFQktVVcQKt42c6OudVfzzcQDFKbiO4hD0tOOc1JfmYIG2fLKuqRsMvCQNCBvtbJf6WHoxunz", "realm": "RT", "familyName": "Sochaiyun", "givenName": "Jakrapat", "fullName": "Jakrapat Sochaiyun", "profileImage": null, "profileHandle": "RT75169145", "background": null, "initials": "JS", "displayName": "Jakrapat S", "isOfficialUser": false }, "reactionSummary": { "reactions": [ "6 items" ], "totalCount": 0, "activityType": "user", "activityId": "002ea075-bef0-4837-8fe1-0c7597fb454e", "postType": "userReview" }, "mediaType": "movie", "reviewType": "audience" }, { "ratingId": "6646ddf5-e43c-4416-90c6-19f7723ac8b6", "rating": "STAR_1_5", "displayName": "Jakrapat S", "initials": "JS", "isVerified": false, "isSuperReviewer": false, "hasSpoilers": false, "hasProfanity": false, "createDate": "2025-07-03T14:00:21.984Z", "updateDate": "2025-07-03T14:00:57.472Z", "reviewState": "PUBLISHED", "media": { "audienceScore": { "keys": [ "scoreType", "score", "scoreSentiment", "certified", "isActivelyModerated" ] }, "emsId": "faed754c-1f75-30ac-9d93-5e479892db18", "mediaType": "movie", "primaryImageUrl": "https://resizing.flixster.com/fpo_YIKk9_EAgnlsboOcHEVeekQ=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzFlODdlYjg1LTlhODEtNDYxYy04YmY1LTc4OGEyYzU1YjQ0Zi5qcGc=", "primaryVideo": { "keys": [ "mpxId", "publicId" ] }, "title": "Jurassic World Rebirth", "tomatometerScore": { "keys": [ "certified", "score", "scoreSentiment" ] }, "vanity": "jurassic_world_rebirth", "posterUri": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/fpo_YIKk9_EAgnlsboOcHEVeekQ=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzFlODdlYjg1LTlhODEtNDYxYy04YmY1LTc4OGEyYzU1YjQ0Zi5qcGc=" }, "user": { "encryptedUserId": "EWkfKEsE3toDCYzfL8Hj7IVKIaacERSo0FnXFQktVVcQKt42c6OudVfzzcQDFKbiO4hD0tOOc1JfmYIG2fLKuqRsMvCQNCBvtbJf6WHoxunz", "realm": "RT", "familyName": "Sochaiyun", "givenName": "Jakrapat", "fullName": "Jakrapat Sochaiyun", "profileImage": null, "profileHandle": "RT75169145", "background": null, "initials": "JS", "displayName": "Jakrapat S", "isOfficialUser": false }, "reactionSummary": { "reactions": [ "6 items" ], "totalCount": 0, "activityType": "user", "activityId": "6646ddf5-e43c-4416-90c6-19f7723ac8b6", "postType": "userReview" }, "mediaType": "movie", "reviewType": "audience" } ], "pageInfo": { "hasNextPage": false, "hasPreviousPage": false, "endCursor": null, "startCursor": null }, "meta": { "movieCount": 2, "tvCount": 0, "totalReturned": 2, "movieCountInPage": 2, "tvCountInPage": 0 } } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get user reviews", "tags": [ "Users" ] } }, "/api/celebrities/slug/{slug}": { "get": { "description": "Returns celebrity details for a Rotten Tomatoes celebrity slug.", "operationId": "Get celebrity details by slug", "parameters": [ { "name": "slug", "required": true, "in": "path", "description": "Rotten Tomatoes celebrity slug from /celebrity/[slug].", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Celebrity details resolved from slug." } }, "summary": "Get celebrity details by slug", "tags": [ "Celebrities" ] } }, "/api/celebrities/{id}": { "get": { "operationId": "Get celebrity details", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Celebrity details.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "Batman" }, "vanity": { "type": "string", "example": "batman" }, "highestTomatometerScoreMovie": { "type": "object", "properties": { "title": { "type": "string", "example": "The Pleasure of Being Robbed" }, "emsMovieId": { "type": "string", "example": "061564fb-27ee-3d76-994c-c8ab9b994088" }, "mediaUrl": { "type": "string", "example": "/m/the-pleasure-of-being-robbed" }, "vanity": { "type": "string", "example": "the-pleasure-of-being-robbed" }, "releaseYear": { "type": "string", "example": "2008" }, "tomatometerScore": { "type": "object", "properties": { "score": { "type": "string", "example": "27" }, "scoreSentiment": { "type": "string", "example": "NEGATIVE" }, "certified": { "type": "boolean", "example": false } } } } }, "lowestTomatometerScoreMovie": { "type": "object", "properties": { "title": { "type": "string", "example": "The Pleasure of Being Robbed" }, "emsMovieId": { "type": "string", "example": "061564fb-27ee-3d76-994c-c8ab9b994088" }, "mediaUrl": { "type": "string", "example": "/m/the-pleasure-of-being-robbed" }, "vanity": { "type": "string", "example": "the-pleasure-of-being-robbed" }, "releaseYear": { "type": "string", "example": "2008" }, "tomatometerScore": { "type": "object", "properties": { "score": { "type": "string", "example": "27" }, "scoreSentiment": { "type": "string", "example": "NEGATIVE" }, "certified": { "type": "boolean", "example": false } } } } }, "highestPopcornmeterScoreMovie": { "type": "object", "properties": { "title": { "type": "string", "example": "The Pleasure of Being Robbed" }, "emsMovieId": { "type": "string", "example": "061564fb-27ee-3d76-994c-c8ab9b994088" }, "mediaUrl": { "type": "string", "example": "/m/the-pleasure-of-being-robbed" }, "vanity": { "type": "string", "example": "the-pleasure-of-being-robbed" }, "releaseYear": { "type": "string", "example": "2008" }, "audienceScore": { "type": "object", "properties": { "score": { "type": "string", "example": "36" }, "scoreSentiment": { "type": "string", "example": "NEGATIVE" }, "certified": { "type": "boolean", "example": false } } } } }, "lowestPopcornmeterScoreMovie": { "type": "object", "properties": { "title": { "type": "string", "example": "The Pleasure of Being Robbed" }, "emsMovieId": { "type": "string", "example": "061564fb-27ee-3d76-994c-c8ab9b994088" }, "mediaUrl": { "type": "string", "example": "/m/the-pleasure-of-being-robbed" }, "vanity": { "type": "string", "example": "the-pleasure-of-being-robbed" }, "releaseYear": { "type": "string", "example": "2008" }, "audienceScore": { "type": "object", "properties": { "score": { "type": "string", "example": "36" }, "scoreSentiment": { "type": "string", "example": "NEGATIVE" }, "certified": { "type": "boolean", "example": false } } } } }, "movieCredits": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "example": "The Pleasure of Being Robbed" }, "mediaUrl": { "type": "string", "example": "/m/the-pleasure-of-being-robbed" }, "emsMovieId": { "type": "string", "example": "061564fb-27ee-3d76-994c-c8ab9b994088" }, "vanity": { "type": "string", "example": "the-pleasure-of-being-robbed" }, "posterUri": { "type": "string", "example": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/-XZAfHZM39UwaGJIF..." }, "releaseYear": { "type": "string", "example": "2008" }, "tomatometerScore": { "type": "object", "properties": { "score": { "type": "string", "example": "27" }, "scoreSentiment": { "type": "string", "example": "NEGATIVE" }, "certified": { "type": "boolean", "example": false } } }, "audienceScore": { "type": "object", "properties": { "score": { "type": "string", "example": "36" }, "scoreSentiment": { "type": "string", "example": "NEGATIVE" }, "certified": { "type": "boolean", "example": false } } }, "credits": { "type": "array", "items": { "type": "string", "example": "Actor" } }, "characterNames": { "type": "array", "items": { "type": "string", "example": "Hello Beautiful / Handsome" } } } } }, "tvSeriesCredits": { "type": "array", "items": {} } } }, "example": { "name": "Batman", "vanity": "batman", "highestTomatometerScoreMovie": { "title": "The Pleasure of Being Robbed", "emsMovieId": "061564fb-27ee-3d76-994c-c8ab9b994088", "mediaUrl": "/m/the-pleasure-of-being-robbed", "vanity": "the-pleasure-of-being-robbed", "releaseYear": "2008", "tomatometerScore": { "score": "27", "scoreSentiment": "NEGATIVE", "certified": false } }, "lowestTomatometerScoreMovie": { "title": "The Pleasure of Being Robbed", "emsMovieId": "061564fb-27ee-3d76-994c-c8ab9b994088", "mediaUrl": "/m/the-pleasure-of-being-robbed", "vanity": "the-pleasure-of-being-robbed", "releaseYear": "2008", "tomatometerScore": { "score": "27", "scoreSentiment": "NEGATIVE", "certified": false } }, "highestPopcornmeterScoreMovie": { "title": "The Pleasure of Being Robbed", "emsMovieId": "061564fb-27ee-3d76-994c-c8ab9b994088", "mediaUrl": "/m/the-pleasure-of-being-robbed", "vanity": "the-pleasure-of-being-robbed", "releaseYear": "2008", "audienceScore": { "score": "36", "scoreSentiment": "NEGATIVE", "certified": false } }, "lowestPopcornmeterScoreMovie": { "title": "The Pleasure of Being Robbed", "emsMovieId": "061564fb-27ee-3d76-994c-c8ab9b994088", "mediaUrl": "/m/the-pleasure-of-being-robbed", "vanity": "the-pleasure-of-being-robbed", "releaseYear": "2008", "audienceScore": { "score": "36", "scoreSentiment": "NEGATIVE", "certified": false } }, "movieCredits": [ { "title": "The Pleasure of Being Robbed", "mediaUrl": "/m/the-pleasure-of-being-robbed", "emsMovieId": "061564fb-27ee-3d76-994c-c8ab9b994088", "vanity": "the-pleasure-of-being-robbed", "posterUri": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p189728_p_v10_aa.jpg", "releaseYear": "2008", "tomatometerScore": { "score": "27", "scoreSentiment": "NEGATIVE", "certified": false }, "audienceScore": { "score": "36", "scoreSentiment": "NEGATIVE", "certified": false }, "credits": [ "Actor" ], "characterNames": [ "Hello Beautiful / Handsome" ] } ], "tvSeriesCredits": [] } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get celebrity details", "tags": [ "Celebrities" ] } }, "/api/celebrities/slug/{slug}/filmography/movie": { "get": { "description": "Returns celebrity movie filmography for a Rotten Tomatoes celebrity slug.", "operationId": "Get celebrity movie filmography by slug", "parameters": [ { "name": "slug", "required": true, "in": "path", "description": "Rotten Tomatoes celebrity slug from /celebrity/[slug].", "schema": { "type": "string" } }, { "name": "sortType", "required": false, "in": "query", "description": "Sort type value forwarded exactly when provided. No default is injected.", "schema": { "example": "release-date", "type": "string" } }, { "name": "sortDirection", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "after", "required": false, "in": "query", "description": "Cursor after value forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "before", "required": false, "in": "query", "description": "Reverse cursor before value forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } } ], "responses": { "200": { "description": "Celebrity movie filmography resolved from slug." } }, "summary": "Get celebrity movie filmography by slug", "tags": [ "Celebrities" ] } }, "/api/celebrities/{id}/filmography/movie": { "get": { "operationId": "Get celebrity movie filmography", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "sortType", "required": false, "in": "query", "description": "Sort type value forwarded exactly when provided. No default is injected.", "schema": { "example": "release-date", "type": "string" } }, { "name": "sortDirection", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "after", "required": false, "in": "query", "description": "Cursor after value forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } }, { "name": "before", "required": false, "in": "query", "description": "Reverse cursor before value forwarded exactly when provided, including an explicit empty value.", "schema": { "example": "", "type": "string" } } ], "responses": { "200": { "description": "Celebrity movie filmography.", "content": { "application/json": { "schema": { "type": "object", "properties": { "movieCredits": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "example": "The Pleasure of Being Robbed" }, "mediaUrl": { "type": "string", "example": "/m/the-pleasure-of-being-robbed" }, "emsMovieId": { "type": "string", "example": "061564fb-27ee-3d76-994c-c8ab9b994088" }, "vanity": { "type": "string", "example": "the-pleasure-of-being-robbed" }, "posterUri": { "type": "string", "example": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/-XZAfHZM39UwaGJIF..." }, "releaseYear": { "type": "string", "example": "2008" }, "tomatometerScore": { "type": "object", "properties": { "score": { "type": "string", "example": "27" }, "scoreSentiment": { "type": "string", "example": "NEGATIVE" }, "certified": { "type": "boolean", "example": false } } }, "audienceScore": { "type": "object", "properties": { "score": { "type": "string", "example": "36" }, "scoreSentiment": { "type": "string", "example": "NEGATIVE" }, "certified": { "type": "boolean", "example": false } } }, "credits": { "type": "array", "items": { "type": "string", "example": "Actor" } }, "characterNames": { "type": "array", "items": { "type": "string", "example": "Hello Beautiful / Handsome" } } } } }, "pageInfo": { "type": "object", "properties": { "startCursor": { "type": "string", "example": "MA==" }, "endCursor": { "type": "string", "example": "MA==" }, "hasNextPage": { "type": "boolean", "example": false }, "hasPreviousPage": { "type": "boolean", "example": false } } }, "totalCount": { "type": "integer", "example": 1 } } }, "example": { "movieCredits": [ { "title": "The Pleasure of Being Robbed", "mediaUrl": "/m/the-pleasure-of-being-robbed", "emsMovieId": "061564fb-27ee-3d76-994c-c8ab9b994088", "vanity": "the-pleasure-of-being-robbed", "posterUri": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p189728_p_v10_aa.jpg", "releaseYear": "2008", "tomatometerScore": { "score": "27", "scoreSentiment": "NEGATIVE", "certified": false }, "audienceScore": { "score": "36", "scoreSentiment": "NEGATIVE", "certified": false }, "credits": [ "Actor" ], "characterNames": [ "Hello Beautiful / Handsome" ] } ], "pageInfo": { "startCursor": "MA==", "endCursor": "MA==", "hasNextPage": false, "hasPreviousPage": false }, "totalCount": 1 } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get celebrity movie filmography", "tags": [ "Celebrities" ] } }, "/api/critics/{id}": { "get": { "operationId": "Get critic details", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Critic details.", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "displayName": { "type": "string", "example": "Ben Bateman" }, "initials": { "type": "string", "example": "BB" }, "rottenTomatoesUrl": { "type": "string", "example": "https://www.rottentomatoes.com/critic/ben-bateman" }, "isTopCritic": { "type": "boolean", "example": false }, "tomatometerApproved": { "type": "boolean", "example": false }, "vanity": { "type": "string", "example": "ben-bateman" }, "encryptedCriticId": { "type": "string", "example": "Vy24PMrW" }, "biography": { "type": "string", "example": "" }, "websiteUrl": { "type": "string", "example": "" }, "reviews": { "type": "array", "items": { "type": "object", "properties": { "reviewId": { "type": "string", "example": "2646144" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "originalScore": { "type": "string", "example": "" }, "isTopReview": { "type": "boolean", "example": false }, "publicationReviewUrl": { "type": "string", "example": "https://www.youtube.com/watch?v=QaizzB_Wtuw" }, "createDate": { "type": "string", "example": "2019-11-15T21:31:37.000Z" }, "updateDate": { "type": "string", "example": "2025-04-07T14:33:27.000Z" }, "reviewQuote": { "type": "string", "example": "The performances are electric." }, "language": { "type": "string", "example": "English" }, "publication": { "type": "object", "properties": { "name": { "type": "string", "example": "Schmoes Know" }, "editorialUrl": { "type": "string", "example": "http://schmoesknow.com/" }, "isTopPublication": { "type": "boolean", "example": false }, "tomatometerApproved": { "type": "boolean", "example": true }, "encryptedPublicationId": { "type": "string", "example": "krLn6Nyw" }, "publicationId": { "type": "string", "example": "2453" } } }, "media": { "type": "object", "properties": { "mediaType": { "type": "string", "example": "movie" }, "emsMovieId": { "type": "string", "example": "27b621dd-46c0-3deb-90be-d63e84f9fc32" }, "posterUri": { "type": "string", "example": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/57WJsL4p6a3Q0O-xS..." }, "primaryImageUrl": { "type": "string", "example": "https://resizing.flixster.com/57WJsL4p6a3Q0O-xSSbus4KI8X0=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzZjNWVkN2M3LTUyNjYtNGRhMi..." }, "releaseYear": { "type": "string", "example": "2019" }, "rottenTomatoesMovieId": { "type": "string", "example": "771500753" }, "title": { "type": "string", "example": "Ford v Ferrari" }, "tomatometerScore": { "type": "object", "additionalProperties": { "oneOf": [ { "type": "string", "example": "92" }, { "type": "string", "example": "POSITIVE" }, { "type": "boolean", "example": true } ] } }, "audienceScore": { "type": "object", "additionalProperties": { "oneOf": [ { "type": "string", "example": "98" }, { "type": "string", "example": "POSITIVE" }, { "type": "boolean", "example": true } ] } }, "vanity": { "type": "string", "example": "ford_v_ferrari" } } }, "reactionSummary": { "type": "object", "properties": { "reactions": { "type": "array", "items": {} }, "totalCount": { "type": "integer", "example": 0 }, "activityType": { "type": "string", "example": "critic" }, "activityId": { "type": "string", "example": "2646144" }, "postType": { "type": "string", "example": "criticReview" } } } } } }, "reviewCount": { "type": "integer", "example": 1 }, "publicationCount": { "type": "integer", "example": 1 }, "publications": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "Schmoes Know" }, "editorialUrl": { "type": "string", "example": "http://schmoesknow.com/" }, "isTopPublication": { "type": "boolean", "example": false }, "tomatometerApproved": { "type": "boolean", "example": true }, "encryptedPublicationId": { "type": "string", "example": "krLn6Nyw" }, "publicationId": { "type": "string", "example": "2453" } } } }, "criticsGroups": { "type": "array", "items": {} }, "followingCount": { "type": "integer", "example": 0 }, "followersCount": { "type": "integer", "example": 0 }, "isFollowing": { "type": "boolean", "example": false } } } }, "example": [ { "displayName": "Ben Bateman", "initials": "BB", "rottenTomatoesUrl": "https://www.rottentomatoes.com/critic/ben-bateman", "isTopCritic": false, "tomatometerApproved": false, "vanity": "ben-bateman", "encryptedCriticId": "Vy24PMrW", "biography": "", "websiteUrl": "", "reviews": [ { "reviewId": "2646144", "scoreSentiment": "POSITIVE", "originalScore": "", "isTopReview": false, "publicationReviewUrl": "https://www.youtube.com/watch?v=QaizzB_Wtuw", "createDate": "2019-11-15T21:31:37.000Z", "updateDate": "2025-04-07T14:33:27.000Z", "reviewQuote": "The performances are electric.", "language": "English", "publication": { "keys": [ "name", "editorialUrl", "isTopPublication", "tomatometerApproved", "encryptedPublicationId", "publicationId" ] }, "media": { "keys": [ "mediaType", "emsMovieId", "posterUri", "primaryImageUrl", "releaseYear", "rottenTomatoesMovieId", "title", "tomatometerScore", "audienceScore", "vanity" ] }, "reactionSummary": { "keys": [ "reactions", "totalCount", "activityType", "activityId", "postType" ] } } ], "reviewCount": 1, "publicationCount": 1, "publications": [ { "name": "Schmoes Know", "editorialUrl": "http://schmoesknow.com/", "isTopPublication": false, "tomatometerApproved": true, "encryptedPublicationId": "krLn6Nyw", "publicationId": "2453" } ], "criticsGroups": [], "followingCount": 0, "followersCount": 0, "isFollowing": false } ] } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get critic details", "tags": [ "Critics" ] } }, "/api/critics/{encryptedCriticId}/publications": { "get": { "operationId": "Get critic publications", "parameters": [ { "name": "encryptedCriticId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Critic publications.", "content": { "application/json": { "schema": { "type": "object", "properties": { "publications": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "Schmoes Know" }, "isTopPublication": { "type": "boolean", "example": false }, "editorialUrl": { "type": "string", "example": "http://schmoesknow.com/" }, "tomatometerApproved": { "type": "boolean", "example": true }, "encryptedPublicationId": { "type": "string", "example": "krLn6Nyw" }, "publicationId": { "type": "string", "example": "2453" } } } }, "pageInfo": { "type": "object", "properties": { "hasNextPage": { "type": "boolean", "example": false }, "hasPreviousPage": { "type": "boolean", "example": false }, "endCursor": { "type": "string", "example": "MA==" } } } } }, "example": { "publications": [ { "name": "Schmoes Know", "isTopPublication": false, "editorialUrl": "http://schmoesknow.com/", "tomatometerApproved": true, "encryptedPublicationId": "krLn6Nyw", "publicationId": "2453" } ], "pageInfo": { "hasNextPage": false, "hasPreviousPage": false, "endCursor": "MA==" } } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get critic publications", "tags": [ "Critics" ] } }, "/api/critics/{encryptedCriticId}/reviews": { "get": { "operationId": "Get critic reviews", "parameters": [ { "name": "encryptedCriticId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "timestamp", "required": false, "in": "query", "description": "Timestamp value forwarded exactly when provided. No default is injected.", "schema": { "example": "1784575843799", "type": "string" } } ], "responses": { "200": { "description": "Critic reviews.", "content": { "application/json": { "schema": { "type": "object", "properties": { "reviews": { "type": "array", "items": { "type": "object", "properties": { "reviewId": { "type": "string", "example": "2646144" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "originalScore": { "type": "string", "example": "" }, "isTopReview": { "type": "boolean", "example": false }, "publicationReviewUrl": { "type": "string", "example": "https://www.youtube.com/watch?v=QaizzB_Wtuw" }, "createDate": { "type": "string", "example": "2019-11-15T21:31:37.000Z" }, "updateDate": { "type": "string", "example": "2025-04-07T14:33:27.000Z" }, "reviewQuote": { "type": "string", "example": "The performances are electric." }, "language": { "type": "string", "example": "English" }, "publication": { "type": "object", "properties": { "name": { "type": "string", "example": "Schmoes Know" }, "editorialUrl": { "type": "string", "example": "http://schmoesknow.com/" }, "isTopPublication": { "type": "boolean", "example": false }, "tomatometerApproved": { "type": "boolean", "example": true }, "encryptedPublicationId": { "type": "string", "example": "krLn6Nyw" }, "publicationId": { "type": "string", "example": "2453" } } }, "media": { "type": "object", "properties": { "mediaType": { "type": "string", "example": "movie" }, "emsMovieId": { "type": "string", "example": "27b621dd-46c0-3deb-90be-d63e84f9fc32" }, "posterUri": { "type": "string", "example": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/57WJsL4p6a3Q0O-xS..." }, "primaryImageUrl": { "type": "string", "example": "https://resizing.flixster.com/57WJsL4p6a3Q0O-xSSbus4KI8X0=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzZjNWVkN2M3LTUyNjYtNGRhMi..." }, "releaseYear": { "type": "string", "example": "2019" }, "rottenTomatoesMovieId": { "type": "string", "example": "771500753" }, "title": { "type": "string", "example": "Ford v Ferrari" }, "tomatometerScore": { "type": "object", "properties": { "score": { "type": "string", "example": "92" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "certified": { "type": "boolean", "example": true } } }, "audienceScore": { "type": "object", "properties": { "score": { "type": "string", "example": "98" }, "scoreSentiment": { "type": "string", "example": "POSITIVE" }, "certified": { "type": "boolean", "example": true } } }, "vanity": { "type": "string", "example": "ford_v_ferrari" } } }, "reactionSummary": { "type": "object", "properties": { "reactions": { "type": "array", "items": { "type": "object", "additionalProperties": {} } }, "totalCount": { "type": "integer", "example": 0 }, "activityType": { "type": "string", "example": "critic" }, "activityId": { "type": "string", "example": "2646144" }, "postType": { "type": "string", "example": "criticReview" } } } } } }, "totalCount": { "type": "integer", "example": 1 }, "pageInfo": { "type": "object", "properties": { "hasNextPage": { "type": "boolean", "example": false }, "hasPreviousPage": { "type": "boolean", "example": false } } } } }, "example": { "reviews": [ { "reviewId": "2646144", "scoreSentiment": "POSITIVE", "originalScore": "", "isTopReview": false, "publicationReviewUrl": "https://www.youtube.com/watch?v=QaizzB_Wtuw", "createDate": "2019-11-15T21:31:37.000Z", "updateDate": "2025-04-07T14:33:27.000Z", "reviewQuote": "The performances are electric.", "language": "English", "publication": { "name": "Schmoes Know", "editorialUrl": "http://schmoesknow.com/", "isTopPublication": false, "tomatometerApproved": true, "encryptedPublicationId": "krLn6Nyw", "publicationId": "2453" }, "media": { "mediaType": "movie", "emsMovieId": "27b621dd-46c0-3deb-90be-d63e84f9fc32", "posterUri": "https://resizing.flixster.com/3ZvkmVoGsbasxSX66ydiWVCS7dY=/206x305/v2/https://resizing.flixster.com/57WJsL4p6a3Q0O-xSSbus4KI8X0=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzZjNWVkN2M3LTUyNjYtNGRhMi1hMjYxLWY5ZDc1MDViZDVhMS53ZWJw", "primaryImageUrl": "https://resizing.flixster.com/57WJsL4p6a3Q0O-xSSbus4KI8X0=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzZjNWVkN2M3LTUyNjYtNGRhMi1hMjYxLWY5ZDc1MDViZDVhMS53ZWJw", "releaseYear": "2019", "rottenTomatoesMovieId": "771500753", "title": "Ford v Ferrari", "tomatometerScore": { "keys": [ "score", "scoreSentiment", "certified" ] }, "audienceScore": { "keys": [ "score", "scoreSentiment", "certified" ] }, "vanity": "ford_v_ferrari" }, "reactionSummary": { "reactions": [ "6 items" ], "totalCount": 0, "activityType": "critic", "activityId": "2646144", "postType": "criticReview" } } ], "totalCount": 1, "pageInfo": { "hasNextPage": false, "hasPreviousPage": false } } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get critic reviews", "tags": [ "Critics" ] } }, "/api/search": { "get": { "operationId": "Search content, people, critics, and users", "parameters": [ { "name": "query", "required": true, "in": "query", "description": "Search query forwarded to each search index.", "schema": { "example": "bat", "type": "string" } }, { "name": "hitsPerPage", "required": false, "in": "query", "description": "Hits per page value forwarded exactly when provided. No default is injected.", "schema": { "example": "50", "type": "string" } } ], "responses": { "200": { "description": "Algolia search results.", "content": { "application/json": { "schema": { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "hits": { "type": "array", "items": { "type": "object", "properties": { "emsId": { "type": "string" }, "emsVersionId": { "type": "string" }, "tmsId": { "type": "string" }, "rtId": { "type": "integer" }, "type": { "type": "string" }, "title": { "type": "string" }, "titles": { "type": "array", "items": {} }, "vanity": { "type": "string" }, "description": { "type": "string" }, "releaseYear": { "type": "integer" }, "rating": { "type": "string" }, "genres": { "type": "array", "items": {} }, "posterImageUrl": { "type": "string" }, "runTime": { "type": "integer" }, "rottenTomatoes": { "type": "object", "additionalProperties": {} }, "castCrew": { "type": "object", "additionalProperties": {} }, "cast": { "type": "array", "items": {} }, "crew": { "type": "array", "items": {} }, "titleType": { "type": "string" }, "pageViews_popularity": { "type": "integer" }, "trailer": { "type": "object", "additionalProperties": { "oneOf": [ { "type": "string", "example": "2254154307536" }, { "type": "string", "example": "https://statcdn.fandango.com/MPX/image/NBCU_Fandango/354/70/thumb_5ED0FFC0-6329-4661-88CC-159CD357A1BD.jpg" }, { "type": "string", "example": "oBLRO8AfmS2D" }, { "type": "string", "example": "You Are So Not Invited to My Bat Mitzvah: Trailer" }, { "type": "number", "example": 150.984 } ] } }, "typeId": { "type": "integer" }, "promotion": { "type": "integer" }, "updateDate": { "type": "string" }, "isEmsSearchable": { "type": "integer" }, "objectID": { "type": "string" }, "_highlightResult": { "type": "object", "additionalProperties": { "oneOf": [ {}, { "type": "object", "additionalProperties": {} } ] } }, "aka": { "type": "array", "items": {} }, "studios": { "type": "array", "items": {} }, "keywords": { "type": "array", "items": {} }, "name": { "type": "string" }, "names": { "type": "array", "items": {} }, "filmographyCount": { "type": "integer" }, "recentTitleYear": { "type": "string" }, "profileImageUrl": { "type": "string" }, "externalId": { "type": "string" }, "status": { "type": "string" }, "approvedForTm": { "type": "boolean" }, "vanityUrl": { "type": "string" }, "publications": { "type": "array", "items": {} }, "topCountries": { "type": "array", "items": {} }, "designation": { "type": "string" }, "isTopCritic": { "type": "boolean" }, "encryptedCriticId": { "type": "string" }, "suggestSearch": { "type": "string" }, "country": { "type": "string" }, "criticImageUrl": { "type": "string", "example": "https://resizing.flixster.com/BbAgYXoWF8s6nERmGAODKCCeYoU=/180x180/v1.YzsxMDAwMDAyODYyO2o7MjA3MDk7MjA0ODsyNTA7MjUw" }, "editorialUrl": { "type": "string" }, "isTopPublication": { "type": "boolean" }, "encryptedPublicationId": { "type": "string" }, "firstName": { "type": "string" }, "lastInitial": { "type": "string" }, "handle": { "type": "string" }, "userId": { "type": "string" }, "isOfficialUser": { "type": "boolean" } } } }, "nbHits": { "type": "integer" }, "page": { "type": "integer" }, "nbPages": { "type": "integer" }, "hitsPerPage": { "type": "integer" }, "exhaustiveNbHits": { "type": "boolean" }, "exhaustiveTypo": { "type": "boolean" }, "exhaustive": { "type": "object", "properties": { "nbHits": { "type": "boolean" }, "typo": { "type": "boolean" }, "facetsCount": { "type": "boolean" } } }, "query": { "type": "string" }, "params": { "type": "string" }, "index": { "type": "string" }, "renderingContent": { "type": "object", "additionalProperties": true }, "processingTimeMS": { "type": "integer" }, "processingTimingsMS": { "type": "object", "properties": { "_request": { "type": "object", "properties": { "roundTrip": { "type": "integer" } } }, "total": { "type": "integer" }, "getIdx": { "type": "object", "properties": { "load": { "type": "object", "additionalProperties": { "type": "integer", "example": 1 } }, "total": { "type": "integer", "example": 1 } } } } }, "serverTimeMS": { "type": "integer" }, "facets": { "type": "object", "additionalProperties": true }, "exhaustiveFacetsCount": { "type": "boolean" } } } } } }, "example": { "results": [ { "hits": [ { "keys": [ "emsId", "emsVersionId", "tmsId", "rtId", "type", "title", "titles", "vanity", "description", "releaseYear", "rating", "genres", "posterImageUrl", "runTime", "rottenTomatoes", "castCrew", "cast", "crew", "titleType", "pageViews_popularity" ] }, { "keys": [ "emsId", "emsVersionId", "tmsId", "rtId", "type", "title", "titles", "aka", "vanity", "description", "releaseYear", "genres", "posterImageUrl", "studios", "runTime", "rottenTomatoes", "castCrew", "cast", "crew", "keywords" ] }, { "keys": [ "emsId", "emsVersionId", "tmsId", "rtId", "type", "title", "titles", "aka", "vanity", "description", "releaseYear", "rating", "genres", "posterImageUrl", "studios", "runTime", "rottenTomatoes", "castCrew", "cast", "crew" ] } ], "nbHits": 3063, "page": 0, "nbPages": 50, "hitsPerPage": 20, "exhaustiveNbHits": true, "exhaustiveTypo": true, "exhaustive": { "nbHits": true, "typo": true }, "query": "bat", "params": "query=bat", "index": "content_rt", "renderingContent": {}, "processingTimeMS": 1, "processingTimingsMS": { "_request": { "keys": [ "roundTrip" ] }, "total": 1 }, "serverTimeMS": 2 }, { "hits": [ { "keys": [ "emsId", "rtId", "name", "names", "vanity", "filmographyCount", "recentTitleYear", "type", "pageViews_popularity", "isEmsSearchable", "updateDate", "typeId", "profileImageUrl", "objectID", "_highlightResult" ] }, { "keys": [ "emsId", "name", "names", "filmographyCount", "recentTitleYear", "type", "pageViews_popularity", "isEmsSearchable", "updateDate", "typeId", "profileImageUrl", "vanity", "objectID", "_highlightResult" ] }, { "keys": [ "emsId", "name", "names", "filmographyCount", "recentTitleYear", "type", "pageViews_popularity", "isEmsSearchable", "updateDate", "typeId", "profileImageUrl", "vanity", "objectID", "_highlightResult" ] } ], "nbHits": 2173, "page": 0, "nbPages": 50, "hitsPerPage": 20, "exhaustiveNbHits": true, "exhaustiveTypo": true, "exhaustive": { "nbHits": true, "typo": true }, "query": "bat", "params": "query=bat", "index": "people_rt", "renderingContent": {}, "processingTimeMS": 1, "processingTimingsMS": { "_request": { "keys": [ "roundTrip" ] }, "total": 0 }, "serverTimeMS": 4 }, { "hits": [ { "keys": [ "type", "externalId", "name", "status", "approvedForTm", "vanityUrl", "publications", "topCountries", "designation", "isTopCritic", "encryptedCriticId", "suggestSearch", "typeId", "country", "objectID", "_highlightResult" ] }, { "keys": [ "type", "externalId", "name", "status", "approvedForTm", "vanityUrl", "publications", "topCountries", "isTopCritic", "encryptedCriticId", "suggestSearch", "typeId", "country", "objectID", "_highlightResult" ] }, { "keys": [ "type", "externalId", "name", "status", "approvedForTm", "vanityUrl", "publications", "topCountries", "designation", "isTopCritic", "encryptedCriticId", "suggestSearch", "typeId", "country", "objectID", "_highlightResult" ] } ], "nbHits": 90, "page": 0, "nbPages": 5, "hitsPerPage": 20, "facets": {}, "exhaustiveFacetsCount": true, "exhaustiveNbHits": true, "exhaustiveTypo": true, "exhaustive": { "facetsCount": true, "nbHits": true, "typo": true }, "query": "bat", "params": "query=bat&facetFilters=type%3A+Critic&facets=%5B%22typeId%22%5D", "index": "critics", "renderingContent": {}, "processingTimeMS": 1, "processingTimingsMS": { "_request": { "keys": [ "roundTrip" ] }, "total": 0 }, "serverTimeMS": 4 } ] } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Search content, people, critics, and users", "tags": [ "Search" ] } }, "/api/ping": { "get": { "description": "Returns local provider health without an upstream call.", "operationId": "Get provider ping", "parameters": [], "responses": { "200": { "description": "Provider ping.", "content": { "application/json": { "schema": { "type": "object", "properties": { "provider": { "type": "string", "example": "rottentomatoes" }, "ok": { "type": "boolean", "example": true } } }, "example": { "provider": "rottentomatoes", "ok": true } } }, "x-live-schema": { "observedAt": "2026-07-24T15:32:11.016Z", "statusCode": 200, "source": "rottentomatoes-smoke-schema" } } }, "summary": "Get provider ping", "tags": [ "Ping" ] } } }, "info": { "title": "Chooria Provider API - rottentomatoes", "description": "Provider-specific APIs with pluggable browser, captcha, and parser integrations.\n\nFiltered provider: rottentomatoes.", "version": "0.1.0", "contact": {} }, "tags": [ { "name": "Provider", "description": "" } ], "servers": [ { "url": "https://rottentomatoes.apihook.dev", "description": "rottentomatoes provider subdomain" } ], "components": { "securitySchemes": { "RapidAPI Proxy Secret": { "type": "apiKey", "in": "header", "name": "x-rapidapi-proxy-secret", "description": "Provider-specific RapidAPI proxy secret header for production provider APIs." } }, "schemas": {} }, "security": [ { "RapidAPI Proxy Secret": [] } ] }