Rotten Tomatoes movie details

Fetch Rotten Tomatoes metadata for a movie by slug.

← All Rotten Tomatoes endpoints · Capability overview

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