Rotten Tomatoes

Rotten Tomatoes episode detail

Returns Rotten Tomatoes TV episode metadata, scorecard data, parent series/season metadata, and public video metadata. Pass exactly one of path or url.

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

Query parameters

pathstring

Rotten Tomatoes episode path

urlstring

Absolute https://www.rottentomatoes.com episode URL

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "air_date": "2008-01-20",
    "audience_score": {
      "average_rating": "8.40",
      "banded_rating_count": "250,000+ Ratings",
      "certified": true,
      "liked_count": 314,
      "not_liked_count": 49,
      "rating_count": 363,
      "review_count": 363,
      "reviews_page_url": "https://www.rottentomatoes.com/m/inception/reviews",
      "score": 87,
      "score_percent": "87%",
      "score_type": "ALL",
      "sentiment": "POSITIVE",
      "title": "Tomatometer"
    },
    "cast": [
      {
        "name": "Christopher Nolan",
        "url": "https://www.rottentomatoes.com/celebrity/christopher_nolan"
      }
    ],
    "critics_score": {
      "average_rating": "8.40",
      "banded_rating_count": "250,000+ Ratings",
      "certified": true,
      "liked_count": 314,
      "not_liked_count": 49,
      "rating_count": 363,
      "review_count": 363,
      "reviews_page_url": "https://www.rottentomatoes.com/m/inception/reviews",
      "score": 87,
      "score_percent": "87%",
      "score_type": "ALL",
      "sentiment": "POSITIVE",
      "title": "Tomatometer"
    },
    "directors": [
      {
        "name": "Christopher Nolan",
        "url": "https://www.rottentomatoes.com/celebrity/christopher_nolan"
      }
    ],
    "ems_id": "ccda9549-4dcb-3147-9a2b-1106dcf852f7",
    "episode_number": 1,
    "fetched_at": "2026-06-07T14:46:16Z",
    "genres": [
      "Crime"
    ],
    "lifecycle": "NOT_AIRING",
    "media_type": "TvEpisode",
    "parent_season": {
      "ems_id": "71374db9-1350-30fa-b30a-d3f623bbdfc4",
      "path": "/tv/breaking_bad/s01",
      "season_number": 1,
      "title": "Season 1",
      "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01"
    },
    "parent_series": {
      "ems_id": "6a74def4-dc62-319e-ae3d-360dcf360244",
      "path": "/tv/breaking_bad",
      "title": "Breaking Bad",
      "url": "https://www.rottentomatoes.com/tv/breaking_bad"
    },
    "path": "/tv/breaking_bad/s01/e01",
    "producers": [
      {
        "name": "Christopher Nolan",
        "url": "https://www.rottentomatoes.com/celebrity/christopher_nolan"
      }
    ],
    "public_page_derived": true,
    "season_number": 1,
    "source_url": "https://www.rottentomatoes.com/tv/breaking_bad/s01/e01",
    "title": "Pilot",
    "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01/e01",
    "video": {
      "duration": "2:32",
      "title": "Breaking Bad: Official Clip - Walter Wants to Cook",
      "upload_date": "2024-07-11T19:23:03",
      "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01/e01/videos/JR3ymbH1dpLb"
    }
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.