Rotten Tomatoes

Rotten Tomatoes movie and TV data for agents: search, scores, reviews, cast and crew, seasons, episodes, and celebrity filmography.

GET/v1/rotten-tomatoes/search

https://api.vee3.io/v1/rotten-tomatoes/search

10 tokens

Search Rotten Tomatoes for movies, TV series, and celebrities.

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

search_rotten_tomatoes

Parameters2 fields

querystringRequired

Search query for movies, TV series, or celebrities.

max length 256

limitintegerOptional

Maximum number of search results to return (1–50, default 20).

min 1, max 50

Response7 fields

querystring

Echo of the search query.

moviesarrayitems

5 fields

Search hits (movies, TV series, or celebrities). Each entry includes type, slug, title, url, posterUrl, score, and cast when available.

typestring

Result type (movie, tv, or celebrity).

slugstring

Slug for detail lookups (for example inception or breaking-bad).

titlestring

Display title.

scoreinteger

Tomatometer or list score when available.

scoreSentimentstring

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/search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "inception",
    "limit": 20
}

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

Example responses1 example

200Sample search results for inception.

inception_search.json

{
  "query": "inception",
  "movies": [
    {
      "type": "movie",
      "slug": "inception",
      "url": "https://www.rottentomatoes.com/m/inception",
      "title": "Inception",
      "posterUrl": "https://resizing.flixster.com/0TQV6F2mwi62h39go9Oz44Ki4bg=/fit-in/80x126/v2/https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p7825626_p_v10_ae.jpg",
      "releaseYear": "2010",
      "endYear": null,
      "score": 87,
      "scoreSentiment": "POSITIVE",
      "certified": true,
      "cast": [
        "Leonardo DiCaprio",
        "Joseph Gordon-Levitt",
        "Elliot Page"
      ]
    },
    {
      "type": "movie",
      "slug": "invention_of_lying",
      "url": "https://www.rottentomatoes.com/m/invention_of_lying",
      "title": "The Invention of Lying",
      "posterUrl": "https://resizing.flixster.com/9DtRRUi2UfhSq-cWugZfGpsyxr4=/fit-in/80x126/v2/https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p182956_p_v10_aa.jpg",
      "releaseYear": "2009",
      "endYear": null,
      "score": 56,
      "scoreSentiment": "NEGATIVE",
      "certified": false,
      "cast": [
        "Ricky Gervais",
        "Jennifer Garner",
        "Jonah Hill"
      ]
    }
  ]
}

GET/v1/rotten-tomatoes/movies/{movie_slug}

https://api.vee3.io/v1/rotten-tomatoes/movies/{movie_slug}

5 tokens

Fetch Rotten Tomatoes metadata for a movie 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_movie_details

Parameters1 field

movie_slugstringRequired

Movie slug (for example shawshank-redemption).

max length 512

Response15 fields

slugstring

Movie slug.

titlestring

Movie title.

yearstring

Release year.

tomatometerobject

3 fields

Critic Tomatometer score and metadata.

scoreinteger

Numeric score.

scoreRawstring

Formatted score string (for example 89%).

sentimentstring

Score sentiment (for example POSITIVE).

popcornmeterobject

3 fields

Audience Popcornmeter score and metadata.

scoreinteger

Numeric score.

scoreRawstring

Formatted score string (for example 89%).

sentimentstring

Score sentiment (for example POSITIVE).

castarrayitems

3 fields

Featured cast with name, slug, and imageUrl.

namestring

Person name.

slugstring

Celebrity slug when available.

urlstring

Rotten Tomatoes profile or title URL.

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/movies/{movie_slug}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "movie_slug": "shawshank-redemption"
}

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

Example responses1 example

200Sample movie details for The Shawshank Redemption.

shawshank_redemption.json

{
  "slug": "shawshank_redemption",
  "url": "https://www.rottentomatoes.com/m/shawshank_redemption",
  "title": "The Shawshank Redemption",
  "year": "1994",
  "mpaaRating": "R",
  "runtime": "2h 22m",
  "genres": [
    "Drama"
  ],
  "description": "Andy Dufresne (Tim Robbins) is sentenced to two consecutive life terms in prison for the murders of his wife and her lover. While there, he forms a friendship with Red (Morgan Freeman) and adapts to brutal prison life over 19 years.",
  "posterUrl": "https://resizing.flixster.com/AKxrfDANaBRnffewUyMm3jPbMtU=/206x305/v2/https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p15987_p_v12_at.jpg",
  "tomatometer": {
    "score": 89,
    "scoreRaw": "89%",
    "sentiment": "POSITIVE",
    "certified": true,
    "label": "Tomatometer",
    "reviewsLabel": "147 Reviews"
  },
  "popcornmeter": {
    "score": 98,
    "scoreRaw": "98%",
    "sentiment": "POSITIVE",
    "certified": false,
    "label": "Popcornmeter",
    "reviewsLabel": "250,000+ Ratings"
  },
  "directors": [
    {
      "name": "Frank Darabont",
      "slug": "frank_darabont",
      "url": "https://www.rottentomatoes.com/celebrity/frank_darabont"
    }
  ],
  "cast": [
    {
      "name": "Tim Robbins",
      "slug": "tim_robbins",
      "url": "https://www.rottentomatoes.com/celebrity/tim_robbins"
    },
    {
      "name": "Morgan Freeman",
      "slug": "morgan_freeman",
      "url": "https://www.rottentomatoes.com/celebrity/morgan_freeman"
    },
    {
      "name": "Bob Gunton",
      "slug": "bob_gunton",
      "url": "https://www.rottentomatoes.com/celebrity/bob_gunton"
    }
  ],
  "whereToWatch": {
    "affiliates": [
      {
        "name": "Netflix",
        "icon": "netflix",
        "url": "https://www.netflix.com/",
        "isSponsoredLink": true
      }
    ],
    "affiliatesText": "Watch The Shawshank Redemption with a subscription on Netflix, or rent on Fandango at Home."
  }
}

GET/v1/rotten-tomatoes/movies/{movie_slug}/reviews

https://api.vee3.io/v1/rotten-tomatoes/movies/{movie_slug}/reviews

5 tokens

Fetch critic or filtered reviews for a Rotten Tomatoes movie.

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_movie_reviews

Parameters4 fields

movie_slugstringRequired

Movie slug (for example shawshank-redemption).

max length 512

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

Movie slug.

typestring

Review set type (for example critic).

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/movies/{movie_slug}/reviews"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "movie_slug": "shawshank-redemption",
    "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 page for The Shawshank Redemption.

shawshank_critic_reviews.json

{
  "slug": "shawshank_redemption",
  "type": "critic",
  "reviews": [
    {
      "reviewId": "103122387",
      "quote": "Moving, absorbing and a grand platform for the less-is-more talents of Robbins and Freeman, two of the best going around.",
      "sentiment": "POSITIVE",
      "createDate": "2026-04-29T23:37:13.000Z",
      "isTopReview": true,
      "critic": {
        "displayName": "Malcolm Knox",
        "vanity": "malcolm-knox",
        "isTopCritic": false,
        "tomatometerApproved": false,
        "profileUrl": "https://www.rottentomatoes.com/critic/malcolm-knox"
      },
      "publication": {
        "name": "Sydney Morning Herald",
        "isTopPublication": true,
        "tomatometerApproved": true
      }
    },
    {
      "reviewId": "102952644",
      "quote": "The Shawshank Redemption is the cinematic equivalent of therapy, showcasing the power of vulnerability.",
      "sentiment": "POSITIVE",
      "createDate": "2024-09-27T18:12:13.000Z",
      "isTopReview": false,
      "critic": {
        "displayName": "M.N. Miller",
        "vanity": "mn-miller",
        "tomatometerApproved": true,
        "profileUrl": "https://www.rottentomatoes.com/critic/mn-miller"
      },
      "publication": {
        "name": "AwardsWatch",
        "tomatometerApproved": true
      }
    }
  ],
  "pageInfo": {
    "endCursor": "MQ==",
    "hasNextPage": true
  }
}

GET/v1/rotten-tomatoes/movies/{movie_slug}/cast-and-crew

https://api.vee3.io/v1/rotten-tomatoes/movies/{movie_slug}/cast-and-crew

5 tokens

Fetch full cast and crew for a Rotten Tomatoes movie.

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_movie_cast_and_crew

Parameters1 field

movie_slugstringRequired

Movie slug (for example shawshank-redemption).

max length 512

Response5 fields

slugstring

Movie slug.

castarrayitems

3 fields

Cast and crew credits for the movie.

namestring

Person name.

slugstring

Celebrity slug when available.

urlstring

Rotten Tomatoes profile or title URL.

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/movies/{movie_slug}/cast-and-crew"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "movie_slug": "shawshank-redemption"
}

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

Example responses1 example

200Sample cast and crew for The Shawshank Redemption.

shawshank_cast.json

{
  "slug": "shawshank_redemption",
  "url": "https://www.rottentomatoes.com/m/shawshank_redemption/cast-and-crew",
  "title": "The Shawshank Redemption",
  "cast": [
    {
      "slug": "tim_robbins",
      "url": "/celebrity/tim_robbins",
      "name": "Tim Robbins",
      "role": "cast",
      "character": "Andy Dufresne",
      "credits": "Actor"
    },
    {
      "slug": "morgan_freeman",
      "url": "/celebrity/morgan_freeman",
      "name": "Morgan Freeman",
      "role": "cast",
      "character": "Ellis Boyd \"Red\" Redding",
      "credits": "Actor"
    },
    {
      "slug": "bob_gunton",
      "url": "/celebrity/bob_gunton",
      "name": "Bob Gunton",
      "role": "cast",
      "character": "Warden Samuel Norton",
      "credits": "Actor"
    }
  ]
}

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"
    }
  ]
}

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"
    }
  ]
}

GET/v1/rotten-tomatoes/tv/{tv_show_slug}/episodes/{season_number}/{episode_number}

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

5 tokens

Fetch metadata for one episode 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_episode

Parameters3 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

episode_numberstringRequired

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

max length 2

Response4 fields

slugstring

TV series slug.

seasonstring

Season number.

episodestring

Episode number.

titlestring

Episode title.

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

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

Example responses1 example

200Sample episode metadata for Breaking Bad season 1 episode 1.

breaking_bad_s1e1.json

{
  "slug": "breaking_bad",
  "season": "01",
  "episode": "01",
  "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01/e01",
  "title": "Breaking Bad - Season 1, Episode 1",
  "episodeTitle": "Pilot",
  "year": "2008",
  "runtime": "58m",
  "genres": [
    "Crime",
    "Drama"
  ],
  "description": "High-school chemistry teacher Walter White learns he is dying of lung cancer and takes steps to ensure his family's financial future.",
  "tomatometer": {
    "score": 86,
    "scoreRaw": "86%",
    "sentiment": "POSITIVE",
    "label": "Tomatometer",
    "reviewsLabel": "43 Reviews"
  }
}

GET/v1/rotten-tomatoes/tv/{tv_show_slug}/cast-and-crew

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

5 tokens

Fetch full cast and crew for 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_cast_and_crew

Parameters1 field

tv_show_slugstringRequired

TV series slug (for example breaking-bad).

max length 512

Response5 fields

slugstring

TV series slug.

castarrayitems

3 fields

Cast and crew credits for the series.

namestring

Person name.

slugstring

Celebrity slug when available.

urlstring

Rotten Tomatoes profile or title URL.

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}/cast-and-crew"
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 cast and crew for Breaking Bad.

breaking_bad_cast.json

{
  "slug": "breaking_bad",
  "url": "https://www.rottentomatoes.com/tv/breaking_bad/cast-and-crew",
  "title": "Breaking Bad",
  "cast": [
    {
      "slug": "bryan_cranston",
      "url": "/celebrity/bryan_cranston",
      "name": "Bryan Cranston",
      "role": "cast",
      "character": "Walter White",
      "credits": "Actor"
    },
    {
      "slug": "aaron_paul",
      "url": "/celebrity/aaron_paul",
      "name": "Aaron Paul",
      "role": "cast",
      "character": "Jesse Pinkman",
      "credits": "Actor"
    },
    {
      "slug": "anna_gunn",
      "url": "/celebrity/anna_gunn",
      "name": "Anna Gunn",
      "role": "cast",
      "character": "Skyler White",
      "credits": "Actor"
    }
  ]
}

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
  }
}

GET/v1/rotten-tomatoes/celebrities/{celebrity_slug}

https://api.vee3.io/v1/rotten-tomatoes/celebrities/{celebrity_slug}

5 tokens

Fetch Rotten Tomatoes profile and filmography for a celebrity.

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_celebrity_details

Parameters1 field

celebrity_slugstringRequired

Celebrity slug (for example morgan-freeman).

max length 512

Response12 fields

slugstring

Celebrity slug.

namestring

Celebrity name.

moviesarrayitems

4 fields

Movie credits with title, slug, year, and score.

titlestring

Title name.

slugstring

Title slug.

yearstring

Release or air year.

scoreinteger

Tomatometer score when available.

tvarrayitems

4 fields

TV credits with title, slug, year, and score.

titlestring

Title name.

slugstring

Title slug.

yearstring

Release or air year.

scoreinteger

Tomatometer score when 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/celebrities/{celebrity_slug}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "celebrity_slug": "morgan-freeman"
}

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

Example responses1 example

200Sample celebrity profile and filmography for Morgan Freeman.

morgan_freeman.json

{
  "slug": "morgan_freeman",
  "url": "https://www.rottentomatoes.com/celebrity/morgan_freeman",
  "name": "Morgan Freeman",
  "description": "Explore the complete filmography of Morgan Freeman on Rotten Tomatoes.",
  "birthDate": "1937-06-01",
  "birthPlace": "Memphis, Tennessee, USA",
  "movies": [
    {
      "title": "My Dead Friend Zoe",
      "slug": "my_dead_friend_zoe",
      "type": "movie",
      "year": "2024",
      "score": 94,
      "ratingCount": 98
    },
    {
      "title": "The Shawshank Redemption",
      "slug": "shawshank_redemption",
      "type": "movie",
      "year": "1994",
      "score": 89,
      "ratingCount": 147
    },
    {
      "title": "57 Seconds",
      "slug": "57_seconds",
      "type": "movie",
      "year": "2023",
      "score": 13,
      "ratingCount": 8
    }
  ],
  "tv": [
    {
      "title": "Through the Wormhole with Morgan Freeman",
      "slug": "through_the_wormhole_with_morgan_freeman",
      "type": "tv",
      "year": "2010-2017, 2021, 2024",
      "score": null,
      "ratingCount": null
    },
    {
      "title": "The Talk",
      "slug": "the_talk",
      "type": "tv",
      "year": "2013-2014, 2016-2017, 2024",
      "score": null,
      "ratingCount": null
    }
  ]
}