Rotten Tomatoes TV show details

Fetch Rotten Tomatoes metadata for a TV series by slug.

← All Rotten Tomatoes endpoints · Capability overview

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

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

5 tokens

Fetch Rotten Tomatoes metadata for a TV series by slug.

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_details

Parameters1 field

tv_show_slugstringRequired

TV series slug (for example breaking-bad).

max length 512

Response11 fields

slugstring

TV series slug.

titlestring

Series title.

yearstring

Years on air (for example 2008 - 2013).

tomatometerobject

3 fields

Average Tomatometer score and metadata.

scoreinteger

Numeric score.

scoreRawstring

Formatted score string (for example 89%).

sentimentstring

Score sentiment (for example POSITIVE).

popcornmeterobject

3 fields

Average Popcornmeter score and metadata.

scoreinteger

Numeric score.

scoreRawstring

Formatted score string (for example 89%).

sentimentstring

Score sentiment (for example POSITIVE).

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}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "tv_show_slug": "breaking-bad"
}

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

Example responses1 example

200Sample TV show details for Breaking Bad.

breaking_bad.json

{
  "slug": "breaking_bad",
  "url": "https://www.rottentomatoes.com/tv/breaking_bad",
  "title": "Breaking Bad",
  "year": "2008 - 2013",
  "tvRating": "TV-14",
  "seasonCount": "5 Seasons",
  "genres": [
    "Crime",
    "Drama"
  ],
  "description": "High school chemistry teacher Walter White turns to manufacturing meth after a terminal cancer diagnosis, partnering with former student Jesse Pinkman.",
  "posterUrl": "https://resizing.flixster.com/aFlnGpyD8kDQFfHsjleVKHSm4qY=/206x305/v2/https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p185846_b_v8_ad.jpg",
  "tomatometer": {
    "score": 96,
    "scoreRaw": "96%",
    "sentiment": "POSITIVE",
    "certified": false,
    "label": "Avg. Tomatometer",
    "reviewsLabel": "250 Reviews"
  },
  "popcornmeter": {
    "score": 97,
    "scoreRaw": "97%",
    "sentiment": "POSITIVE",
    "label": "Avg. Popcornmeter",
    "reviewsLabel": "25,000+ Ratings"
  },
  "creators": [
    {
      "name": "Vince Gilligan",
      "slug": "vince_gilligan",
      "url": "https://www.rottentomatoes.com/celebrity/vince_gilligan"
    }
  ],
  "cast": [
    {
      "name": "Bryan Cranston",
      "slug": "bryan_cranston",
      "url": "https://www.rottentomatoes.com/celebrity/bryan_cranston"
    },
    {
      "name": "Aaron Paul",
      "slug": "aaron_paul",
      "url": "https://www.rottentomatoes.com/celebrity/aaron_paul"
    },
    {
      "name": "Anna Gunn",
      "slug": "anna_gunn",
      "url": "https://www.rottentomatoes.com/celebrity/anna_gunn"
    }
  ]
}