--- title: "Rotten Tomatoes episode detail" method: GET path: "/rottentomatoes/episode" tags: ["Rotten Tomatoes"] --- # Rotten Tomatoes episode detail `GET /rottentomatoes/episode` ## Request - Base URL: `https://api.crawlora.net/api/v1` - URL: `https://api.crawlora.net/api/v1/rottentomatoes/episode` - Auth: API key in header `x-api-key` Returns Rotten Tomatoes TV episode metadata, scorecard data, parent series/season metadata, and public video metadata. Pass exactly one of `path` or `url`. ## Query parameters - `path` string - `url` string ## Headers - `x-api-key` string, required ## Response `200` OK - RottentomatoesEpisodeResponseDoc - `code` integer - `data` RottentomatoesEpisodeResponse - `air_date` string: Date the episode first aired, such as `2008-01-20`. - `audience_score` RottentomatoesScore - `average_rating` string: Average rating as shown on the scorecard, such as `8.40`. - `banded_rating_count` string: Approximate number of ratings as shown on the page, such as `250,000+ Ratings`. - `certified` boolean: Whether Rotten Tomatoes marks the score as certified. - `liked_count` integer: Number of ratings that liked the title. - `not_liked_count` integer: Number of ratings that did not like the title. - `rating_count` integer: Number of ratings behind the score. - `review_count` integer: Number of reviews behind the score. - `reviews_page_url` string: URL of the Rotten Tomatoes page that lists the reviews behind this score. - `score` integer: Score as a whole-number percentage. - `score_percent` string: Score as text with a percent sign, such as `87%`. - `score_type` string: Audience group the score covers, such as `ALL` or `VERIFIED`. - `sentiment` string: Overall sentiment of the score, such as `POSITIVE`. - `title` string: Name of the score, such as `Tomatometer` or `Popcornmeter`. - `cast` RottentomatoesPerson[]: People in the cast of the episode. - `image_url` string: URL of the person's photo. - `name` string: Name of the person. - `url` string: Rotten Tomatoes page URL of the person. - `critics_score` RottentomatoesScore - `average_rating` string: Average rating as shown on the scorecard, such as `8.40`. - `banded_rating_count` string: Approximate number of ratings as shown on the page, such as `250,000+ Ratings`. - `certified` boolean: Whether Rotten Tomatoes marks the score as certified. - `liked_count` integer: Number of ratings that liked the title. - `not_liked_count` integer: Number of ratings that did not like the title. - `rating_count` integer: Number of ratings behind the score. - `review_count` integer: Number of reviews behind the score. - `reviews_page_url` string: URL of the Rotten Tomatoes page that lists the reviews behind this score. - `score` integer: Score as a whole-number percentage. - `score_percent` string: Score as text with a percent sign, such as `87%`. - `score_type` string: Audience group the score covers, such as `ALL` or `VERIFIED`. - `sentiment` string: Overall sentiment of the score, such as `POSITIVE`. - `title` string: Name of the score, such as `Tomatometer` or `Popcornmeter`. - `description` string: Short synopsis of the episode. - `directors` RottentomatoesPerson[]: Directors of the episode. - `image_url` string: URL of the person's photo. - `name` string: Name of the person. - `url` string: Rotten Tomatoes page URL of the person. - `ems_id` string: Rotten Tomatoes' own unique id of the episode. - `episode_number` integer: Episode number within its season. - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339). - `genres` string[]: Genres of the episode. - `image_url` string: URL of the episode image. - `lifecycle` string: Airing status, such as `NOT_AIRING`. - `media_type` string: Kind of title, such as `TvEpisode`. - `parent_season` RottentomatoesSeasonSummary - `ems_id` string: Rotten Tomatoes' own unique id of the season. - `path` string: Rotten Tomatoes path of the season page, such as `/tv/breaking_bad/s01`. - `season_number` integer: Number of the season within the series. - `title` string: Season title, such as `Season 1`. - `url` string: Rotten Tomatoes page URL of the season. - `parent_series` RottentomatoesSeriesSummary - `ems_id` string: Rotten Tomatoes' own unique id of the series. - `path` string: Rotten Tomatoes path of the series page, such as `/tv/breaking_bad`. - `title` string: Title of the series, as Rotten Tomatoes shows it. - `url` string: Rotten Tomatoes page URL of the series. - `path` string: Rotten Tomatoes path of the episode page, such as `/tv/breaking_bad/s01/e01`. - `producers` RottentomatoesPerson[]: Producers of the episode. - `image_url` string: URL of the person's photo. - `name` string: Name of the person. - `url` string: Rotten Tomatoes page URL of the person. - `public_page_derived` boolean: Always `true`: the data comes from publicly visible Rotten Tomatoes pages. - `season_number` integer: Number of the season the episode belongs to. - `source_url` string: URL the data was read from. - `title` string: Title of the episode, as Rotten Tomatoes shows it. - `url` string: Rotten Tomatoes page URL of the episode. - `video` RottentomatoesEpisodeVideo - `description` string: Description of the video. - `duration` string: Length of the video as text, such as `2:32`. - `thumbnail` string: URL of the video thumbnail image. - `title` string: Title of the video. - `upload_date` string: Date and time the video was uploaded, such as `2024-07-11T19:23:03`. - `url` string: Rotten Tomatoes page URL of the video. - `msg` string ## Other responses - `400`: Bad Request - `404`: Not Found - `429`: Too Many Requests - `500`: Internal Server Error - `503`: Service Unavailable --- [API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)