Rotten Tomatoes TV season reviews

Fetch critic or filtered reviews for a TV season on Rotten Tomatoes.

← All Rotten Tomatoes endpoints · Capability overview

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

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

5 tokens

Fetch critic or filtered reviews for a TV season on Rotten Tomatoes.

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_reviews

Parameters5 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

cursorstringOptional

Pagination cursor from a previous response pageInfo.endCursor field.

max length 4096

typestringOptional

Review filter. Use critic for critic reviews; omit for the default set.

max length 32

limitintegerOptional

Maximum number of review pages to return (1–50, default 20).

min 1, max 50

Response9 fields

slugstring

TV series slug.

seasonstring

Season number.

reviewsarrayitems

3 fields

Review entries with quote, sentiment, critic, and publication.

reviewIdstring

Review identifier.

quotestring

Review excerpt or quote.

sentimentstring

Review sentiment (for example POSITIVE).

pageInfoobject

2 fields

Pagination metadata for review listings.

endCursorstring

Cursor for the next page of reviews.

hasNextPageboolean

Whether more review pages are available.

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}/reviews"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "tv_show_slug": "breaking-bad",
    "season_number": "1",
    "type": "critic",
    "limit": 20
}

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

Example responses1 example

200Sample critic reviews for Breaking Bad season 1.

breaking_bad_season_1_reviews.json

{
  "slug": "breaking_bad",
  "season": "01",
  "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01/reviews",
  "type": "critic",
  "reviews": [
    {
      "quote": "There's some initial growing pains but the beginning to this fantastic show is still top-notch television. Walter White and Jesse Pinkman's early adventures are darkly comedic gold.",
      "sentiment": "positive",
      "createDate": "2022-08-19T01:41:08.000Z",
      "critic": {
        "displayName": "Cody Leach",
        "profileUrl": "https://www.rottentomatoes.com/critic/cody-leach",
        "isTopCritic": false,
        "tomatometerApproved": true
      },
      "publication": {
        "name": "Cody Leach (YouTube)",
        "isTopPublication": false
      }
    },
    {
      "quote": "If dark comedy is your flavour, this is a veritable feast.",
      "sentiment": "positive",
      "createDate": "2017-10-24T18:32:44.000Z",
      "critic": {
        "displayName": "William Thomas",
        "profileUrl": "https://www.rottentomatoes.com/critic/william-thomas",
        "isTopCritic": false
      },
      "publication": {
        "name": "Empire Magazine",
        "isTopPublication": true
      }
    }
  ],
  "pageInfo": {
    "endCursor": "MQ==",
    "hasNextPage": true
  }
}