# Rotten Tomatoes API: Get reviews

> Reads the newest critic or audience reviews for a Rotten Tomatoes movie or TV show. For a whole TV show it combines reviews from its seasons.

Unofficial. Not affiliated with or endorsed by Rotten Tomatoes.

- Page: https://fous.com/methods/rottentomatoes.com/get-reviews
- Method: `rottentomatoes.com/get_reviews`, version 1
- Website: rottentomatoes.com
- Returns: title, link, reviews (reviewer, publication, verdict, stars, text, date, link)
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `year` | integer | no |  | Release year to distinguish titles. Example: 2023 |
| `title` | string | yes | `"https://www.rottentomatoes.com/m/oppenheimer_2023"` | Movie or TV show title, or its Rotten Tomatoes link. Example: Oppenheimer |
| `season` | integer | no |  | TV season number; leave blank for the whole show. Example: 1 |
| `max_results` | integer | no | `60` | Most reviews to return, up to 100. Example: 20 Default 20. |
| `review_type` | string | no | `"critics"` | Which reviews to read. Example: critics One of "critics", "audience". Default "critics". |
| `top_critics_only` | boolean | no | `true` | Show only top critics when reading critic reviews. Example: false Default false. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "title": "https://www.rottentomatoes.com/m/oppenheimer_2023",
  "max_results": 60,
  "review_type": "critics",
  "top_critics_only": true
}
```

Its output:

```json
{
  "link": "https://www.rottentomatoes.com/m/oppenheimer_2023",
  "title": "Oppenheimer",
  "reviews": []
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"rottentomatoes.com/get_reviews","input":{"title":"https://www.rottentomatoes.com/m/oppenheimer_2023","max_results":60,"review_type":"critics","top_critics_only":true}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the latest critic reviews for the 2023 movie Oppenheimer, 10 of them please
- What are audience reviews saying about season 2 of The Bear?
- Get the newest top critic reviews for Dune from 2021, max 15
- I want to read recent audience reviews of the 1999 film The Matrix on rottentomatoes.com
- Pull season 1 critic reviews for the TV show Severance, limited to 25 results

## Input schema

```json
{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Release year to distinguish titles. Example: 2023"
    },
    "title": {
      "type": "string",
      "description": "Movie or TV show title, or its Rotten Tomatoes link. Example: Oppenheimer"
    },
    "season": {
      "type": "integer",
      "minimum": 1,
      "description": "TV season number; leave blank for the whole show. Example: 1"
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Most reviews to return, up to 100. Example: 20"
    },
    "review_type": {
      "enum": [
        "critics",
        "audience"
      ],
      "type": "string",
      "default": "critics",
      "description": "Which reviews to read. Example: critics"
    },
    "top_critics_only": {
      "type": "boolean",
      "default": false,
      "description": "Show only top critics when reading critic reviews. Example: false"
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "title",
    "link",
    "reviews"
  ],
  "properties": {
    "link": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "reviews": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "link": {
            "type": "string"
          },
          "verdict": {
            "type": [
              "string",
              "null"
            ]
          },
          "publication": {
            "type": [
              "string",
              "null"
            ]
          },
          "review_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "review_text": {
            "type": "string"
          },
          "reviewer_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "star_rating_out_of_5": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [Rotten Tomatoes API: Get scores](https://fous.com/methods/rottentomatoes.com/get-scores.md): Gets Rotten Tomatoes critic and audience scores and title details for a movie or TV show, optionally for one TV season. Audience rating counts may be unavailable for series.
- [Rotten Tomatoes API: List movies](https://fous.com/methods/rottentomatoes.com/list-movies.md): Lists Rotten Tomatoes movies in theaters, coming soon, or at home, by genre and site sort order, with scores, release dates, age ratings, posters and links.
- [Metacritic API: List best-reviewed titles](https://fous.com/methods/metacritic.com/list-best-reviewed.md): Lists the highest-Metascore games, movies or TV shows on Metacritic for a release year or all time. You can filter by genre, and by platform for games.
- [Metacritic API: Get scores](https://fous.com/methods/metacritic.com/get-scores.md): Finds a game, movie or TV show on Metacritic by name and returns critic and user scores with title details.
- [Apple API: Get podcast reviews](https://fous.com/methods/podcasts.apple.com/get-podcast-reviews.md): Gets a podcast's country-specific rating total and average, plus up to 500 listener reviews sorted by newest or most helpful.
- [IMDb API: Get movie or show](https://fous.com/methods/imdb.com/get-movie-or-show.md): Gets a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null.
- [themoviedb.org API: Get movie details](https://fous.com/methods/themoviedb.org/get-movie.md): Finds a movie on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country.
- [Pitchfork API: List latest album reviews](https://fous.com/methods/pitchfork.com/list-latest-reviews.md): Lists the newest Pitchfork album reviews. You can filter them by genre or limit them to Best New Music.
- [All Rotten Tomatoes methods](https://fous.com/methods/rottentomatoes.com.md)