Rotten Tomatoes movie reviews

Fetch critic or filtered reviews for a Rotten Tomatoes movie.

← All Rotten Tomatoes endpoints · Capability overview

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