Rotten Tomatoes celebrity details

Fetch Rotten Tomatoes profile and filmography for a celebrity.

← All Rotten Tomatoes endpoints · Capability overview

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