Endpoint Playground

Try the Rotten Tomatoes season detail API

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

What a live request returned

14 Oct 2026: 7 episodes; 6 fields had a value in every checked item.

Observed request: GET /rottentomatoes/season?path=%2Ftv%2Fbreaking_bad%2Fs01
Fields with a value in every checked item: episode_number, title, path, url, air_date, description

Sample value profiles: air_date: 2008-01-20 to 2008-03-09; episode_number: 1 to 7, median 4; title: “Pilot” and 6 other values.

Request: GET /rottentomatoes/season
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.91 s
Monitored request: GET /rottentomatoes/season?path=%2Ftv%2Fbreaking_bad%2Fs01

Rotten Tomatoes season detail API documentation Rotten Tomatoes platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/rottentomatoes/season' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
path	string	No		Rotten Tomatoes season path
url	string	No		Absolute https://www.rottentomatoes.com season URL

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Season 1",
    "path": "/tv/breaking_bad/s01",
    "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01",
    "media_type": "TvSeason",
    "parent_series": {
      "title": "Breaking Bad",
      "path": "/tv/breaking_bad"
    },
    "episode_count": 7,
    "critics_score": {
      "score_percent": "86%"
    },
    "audience_score": {
      "score_percent": "95%"
    },
    "public_page_derived": true
  }
}

More Rotten Tomatoes endpoints

Rotten Tomatoes browse filter discovery Rotten Tomatoes movie discovery rows Rotten Tomatoes TV discovery rows Rotten Tomatoes critic directory Rotten Tomatoes editorial content listing Rotten Tomatoes editorial article detail Rotten Tomatoes editorial search Rotten Tomatoes editorial section archive Rotten Tomatoes editorial taxonomy discovery Rotten Tomatoes editorial taxonomy terms Rotten Tomatoes editorial content types Rotten Tomatoes episode detail All 20 Rotten Tomatoes endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestrottentomatoes.seasonResponseDocRotten Tomatoes

GET /rottentomatoes/season

Rotten Tomatoes season detail

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

Response behavior

- `data.public_page_derived` is `true`. - `episodes` comes from public `TVSeason` JSON-LD `episode` entries. - `critics_score` and `audience_score` are included only when the public page exposes scorecard data. - Upstream challenge pages, malformed page data, or parser drift are returned as typed upstream errors.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Season 1",
    "path": "/tv/breaking_bad/s01",
    "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01",
    "media_type": "TvSeason",
    "parent_series": {
      "title": "Breaking Bad",
      "path": "/tv/breaking_bad"
    },
    "episode_count": 7,
    "critics_score": {
      "score_percent": "86%"
    },
    "audience_score": {
      "score_percent": "95%"
    },
    "public_page_derived": true
  }
}

Endpoint Playground

Try the Rotten Tomatoes season detail API

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

What a live request returned

14 Oct 2026: 7 episodes; 6 fields had a value in every checked item.

Observed request: GET /rottentomatoes/season?path=%2Ftv%2Fbreaking_bad%2Fs01
Fields with a value in every checked item: episode_number, title, path, url, air_date, description

Sample value profiles: air_date: 2008-01-20 to 2008-03-09; episode_number: 1 to 7, median 4; title: “Pilot” and 6 other values.

Request: GET /rottentomatoes/season
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.91 s
Monitored request: GET /rottentomatoes/season?path=%2Ftv%2Fbreaking_bad%2Fs01

Rotten Tomatoes season detail API documentation Rotten Tomatoes platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/rottentomatoes/season' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
path	string	No		Rotten Tomatoes season path
url	string	No		Absolute https://www.rottentomatoes.com season URL

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Season 1",
    "path": "/tv/breaking_bad/s01",
    "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01",
    "media_type": "TvSeason",
    "parent_series": {
      "title": "Breaking Bad",
      "path": "/tv/breaking_bad"
    },
    "episode_count": 7,
    "critics_score": {
      "score_percent": "86%"
    },
    "audience_score": {
      "score_percent": "95%"
    },
    "public_page_derived": true
  }
}

More Rotten Tomatoes endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestrottentomatoes.seasonResponseDocRotten Tomatoes

GET /rottentomatoes/season

Rotten Tomatoes season detail

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

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Season 1",
    "path": "/tv/breaking_bad/s01",
    "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01",
    "media_type": "TvSeason",
    "parent_series": {
      "title": "Breaking Bad",
      "path": "/tv/breaking_bad"
    },
    "episode_count": 7,
    "critics_score": {
      "score_percent": "86%"
    },
    "audience_score": {
      "score_percent": "95%"
    },
    "public_page_derived": true
  }
}