# Rotten Tomatoes API: Get scores

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

Unofficial. Not affiliated with or endorsed by Rotten Tomatoes.

- Page: https://fous.com/methods/rottentomatoes.com/get-scores
- Method: `rottentomatoes.com/get_scores`, version 1
- Website: rottentomatoes.com
- Returns: title, year, type, tomatometer, popcornmeter, review counts, consensus, rating, runtime, genres, director, cast, where to watch, box office, poster, 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
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `year` | integer | no | `1984` | Release or series start year to distinguish titles. Example: 2021 |
| `title` | string | yes | `"Dune"` | Movie or TV show name, or its Rotten Tomatoes link. Example: Barbie |
| `season` | integer | no |  | TV season number; omit for the whole series. Example: 2 |

## Output

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

```json
{
  "year": 1984,
  "title": "Dune"
}
```

Its output:

```json
{
  "type": "movie",
  "year": 1984,
  "title": "Dune (1984)",
  "genres": [
    "Sci-Fi",
    "Adventure"
  ],
  "runtime": "2h 17m",
  "director": "David Lynch",
  "age_rating": "PG-13",
  "poster_link": "https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p8382_p_v8_aa.jpg",
  "tomatometer": 36,
  "top_10_cast": [
    "Kyle MacLachlan",
    "Sting",
    "Francesca Annis"
  ],
  "popcornmeter": 65,
  "verified_hot": false,
  "us_box_office": null,
  "critic_reviews": 117,
  "where_to_watch": [],
  "certified_fresh": false,
  "audience_ratings": 12022,
  "critics_consensus": "This truncated adaptation of Frank Herbert's sci-fi masterwork is too dry to work as grand entertainment, but David Lynch's flair for the surreal gives Dune some spice.",
  "rotten_tomatoes_link": "https://www.rottentomatoes.com/m/dune_1984",
  "us_box_office_currency": null
}
```

## 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_scores","input":{"year":1984,"title":"Dune"}}'
```

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

- What's the Tomatometer and Popcornmeter for Oppenheimer from 2023?
- Check Rotten Tomatoes scores for season 3 of The Bear
- how well did Dune Part Two do with critics and audiences on rottentomatoes.com
- Get the critic consensus, runtime, and cast for the 1999 movie The Matrix
- Rotten Tomatoes audience score and review counts for Severance season 2, started 2022

## Input schema

```json
{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Release or series start year to distinguish titles. Example: 2021"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Movie or TV show name, or its Rotten Tomatoes link. Example: Barbie"
    },
    "season": {
      "type": "integer",
      "minimum": 1,
      "description": "TV season number; omit for the whole series. Example: 2"
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "title",
    "year",
    "type",
    "tomatometer",
    "critic_reviews",
    "certified_fresh",
    "popcornmeter",
    "audience_ratings",
    "verified_hot",
    "critics_consensus",
    "age_rating",
    "runtime",
    "genres",
    "director",
    "top_10_cast",
    "where_to_watch",
    "us_box_office",
    "us_box_office_currency",
    "poster_link",
    "rotten_tomatoes_link"
  ],
  "properties": {
    "type": {
      "enum": [
        "movie",
        "TV show"
      ],
      "type": "string"
    },
    "year": {
      "type": [
        "integer",
        "null"
      ]
    },
    "title": {
      "type": "string"
    },
    "genres": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "runtime": {
      "type": [
        "string",
        "null"
      ]
    },
    "director": {
      "type": [
        "string",
        "null"
      ]
    },
    "age_rating": {
      "type": [
        "string",
        "null"
      ]
    },
    "poster_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "tomatometer": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Critics score as a percentage."
    },
    "top_10_cast": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "popcornmeter": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Audience score as a percentage."
    },
    "verified_hot": {
      "type": "boolean"
    },
    "us_box_office": {
      "type": [
        "number",
        "null"
      ]
    },
    "critic_reviews": {
      "type": [
        "integer",
        "null"
      ]
    },
    "where_to_watch": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "certified_fresh": {
      "type": "boolean"
    },
    "audience_ratings": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Total audience ratings when the site provides their counts; otherwise null."
    },
    "critics_consensus": {
      "type": [
        "string",
        "null"
      ]
    },
    "rotten_tomatoes_link": {
      "type": "string"
    },
    "us_box_office_currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "USD if US box office is shown."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Rotten Tomatoes API: Get reviews](https://fous.com/methods/rottentomatoes.com/get-reviews.md): 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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Box Office Mojo API: Get movie box office](https://fous.com/methods/boxofficemojo.com/get-movie-box-office.md): Finds a movie on Box Office Mojo by title, with an optional year, and returns its box office totals, release details, theater counts and markets.
- [IMDb API: Get IMDb Parents Guide](https://fous.com/methods/imdb.com/get-parents-guide.md): Gets age certifications and non-spoiler Parents Guide summaries (severity votes and example descriptions for five categories) for a movie or show by title, IMDb link or title ID. A year selects a specific release.
- [All Rotten Tomatoes methods](https://fous.com/methods/rottentomatoes.com.md)