Rotten Tomatoes TV show season

Fetch metadata for one season of a Rotten Tomatoes TV series.

← All Rotten Tomatoes endpoints · Capability overview

GET/v1/rotten-tomatoes/tv/{tv_show_slug}/seasons/{season_number}

https://api.vee3.io/v1/rotten-tomatoes/tv/{tv_show_slug}/seasons/{season_number}

5 tokens

Fetch metadata for one season of a Rotten Tomatoes TV series.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_rotten_tomatoes_tv_show_season

Parameters2 fields

tv_show_slugstringRequired

TV series slug (for example breaking-bad).

max length 512

season_numberstringRequired

Season number as one or two digits (for example 1 or 01).

max length 2

Response5 fields

slugstring

TV series slug.

seasonstring

Season identifier.

episodesarrayitems

2 fields

Episodes in the season when listed.

titlestring

Episode title.

episodestring

Episode number.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, rotten_tomatoes_not_configured, rotten_tomatoes_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/rotten-tomatoes/tv/{tv_show_slug}/seasons/{season_number}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "tv_show_slug": "breaking-bad",
    "season_number": "1"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample season metadata for Breaking Bad season 1.

breaking_bad_season_1.json

{
  "slug": "breaking_bad",
  "season": "01",
  "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01",
  "title": "Season 1 - Breaking Bad",
  "seriesTitle": "Breaking Bad",
  "year": "2008",
  "tomatometer": {
    "score": 86,
    "scoreRaw": "86%",
    "sentiment": "POSITIVE",
    "certified": true,
    "label": "Tomatometer",
    "reviewsLabel": "43 Reviews"
  },
  "popcornmeter": {
    "score": 95,
    "scoreRaw": "95%",
    "sentiment": "POSITIVE",
    "label": "Popcornmeter",
    "reviewsLabel": "5,000+ Ratings"
  },
  "episodes": [
    {
      "episodeNumber": "1",
      "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01/e01",
      "title": "Pilot",
      "description": "High-school chemistry teacher Walter White learns he is dying of lung cancer and takes steps to ensure his family's financial future.",
      "airDate": "2008-01-20"
    },
    {
      "episodeNumber": "2",
      "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01/e02",
      "title": "Cat's in the Bag...",
      "description": "Walter and Jesse are left with a mess to dispose of after their desert debacle; Skyler grows suspicious of Walt's recent activity.",
      "airDate": "2008-01-27"
    }
  ]
}