Skip to content
Fous
Fous
Log in to Fous

Rotten Tomatoes

Entertainmentrottentomatoes.com

Movie scores, film reviews and movie listings

Back to tools

Rotten Tomatoes returns movie and TV details, scores, newest reviews, and listings for theaters, coming soon, or at home; series rating counts may be unavailable.

Get reviews

Read newest critic or audience reviews for a Rotten Tomatoes movie or TV show. For a whole TV show, combines reviews from its seasons; audience review links open the review list.

Your information

Movie or TV show title, or its Rotten Tomatoes link. Example: Oppenheimer

TV season number; leave blank for the whole show. Example: 1

Most reviews to return, up to 100. Example: 20

Which reviews to read. Example: critics

More options

Release year to distinguish titles. Example: 2023

Show only top critics when reading critic reviews. Example: false

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

Season 1

View on Rotten Tomatoes

Reviews

    • Choose an action

    About the Rotten Tomatoes tool

    Rotten Tomatoes returns critic and audience scores and title details through Get scores, using a movie or TV title and optionally a year or season.

    Get reviews returns recent critic or audience reviews for a movie or TV show, using a title and optional year, season, review type, and result count.

    List movies returns movies in theaters, coming soon, or at home, filtered by genre and ordered by a selected site sort order.

    Built from rottentomatoes.com. Last checked Sep 29, 2026.

    Actions

    Get reviews

    1 credit

    Read newest critic or audience reviews for a Rotten Tomatoes movie or TV show. For a whole TV show, combines reviews from its seasons; audience review links open the review list.

    What you provide

    FieldTypeRequiredDescription
    YearyearNumberOptionalRelease year to distinguish titles. Example: 2023Example: 2023
    TitletitleTextRequiredMovie or TV show title, or its Rotten Tomatoes link. Example: OppenheimerExample: The Last of Us
    SeasonseasonNumberOptionalTV season number; leave blank for the whole show. Example: 1Example: 1
    Max Resultsmax_resultsNumberOptionalMost reviews to return, up to 100. Example: 20Example: 5
    Review Typereview_typeTextOptionalWhich reviews to read. Example: criticsExample: Audience
    Top Critics Onlytop_critics_onlyYes or noOptionalShow only top critics when reading critic reviews. Example: falseExample: Yes

    What you get

    FieldTypeDescription
    LinklinkTextExample: https://www.rottentomatoes.com/tv/the_last_of_us/s01
    TitletitleTextExample: Season 1
    ReviewsreviewsList
    Linkreviews[].linkTextExample: https://www.rottentomatoes.com/tv/the_last_of_us/s01/reviews/all-audience
    Verdictreviews[].verdictTextExample: Rotten
    Publicationreviews[].publicationTextExample: The Saturday Paper
    Review Datereviews[].review_dateDateExample: 2026-09-24
    Review Textreviews[].review_textTextExample: Gran Adaptación de un videojuego a una serie serie. Mantiene la esencia de los…
    Reviewer Namereviews[].reviewer_nameTextExample: Eduardo L
    Star Rating Out of 5reviews[].star_rating_out_of_5NumberExample: 5

    Example result

    For Title: The Last of Us, Season: 1, Max Results: 5, Review Type: Audience

    JSON
    {
  "link": "https://www.rottentomatoes.com/tv/the_last_of_us/s01",
  "title": "Season 1",
  "reviews": [
    {
      "link": "https://www.rottentomatoes.com/tv/the_last_of_us/s01/reviews/all-audience",
      "verdict": null,
      "publication": null,
      "review_date": "2026-09-24",
      "review_text": "Gran Adaptación de un videojuego a una serie serie. Mantiene la esencia de los personajes y consigue dar sentido a una historia que no estaba creada para la televisión. \nMuy buen balance entre acción …",
      "reviewer_name": "Eduardo L",
      "star_rating_out_of_5": 5
    },
    {
      "link": "https://www.rottentomatoes.com/tv/the_last_of_us/s01/reviews/all-audience",
      "verdict": null,
      "publication": null,
      "review_date": "2026-09-16",
      "review_text": "I really hope for more with this series but the casting was horrible besides Pedor Pascal of course. Overall the acting was horrible. ",
      "reviewer_name": "Terrell M",
      "star_rating_out_of_5": 0.5
    },
    {
      "link": "https://www.rottentomatoes.com/tv/the_last_of_us/s01/reviews/all-audience",
      "verdict": null,
      "publication": null,
      "review_date": "2026-09-07",
      "review_text": "I couldn't watch it due to the use of a shaky handheld camera throughout. It made me queasy. So I had to give up. Such a shame and so, so unnecessary. I can't give the series a higher score because, s…",
      "reviewer_name": "Matthew J",
      "star_rating_out_of_5": 0.5
    }
  ]
}

    Get scores

    1 credit

    Get Rotten Tomatoes critic and audience scores and title details for a movie or TV show. Audience rating counts may be unavailable for series.

    What you provide

    FieldTypeRequiredDescription
    YearyearNumberOptionalRelease or series start year to distinguish titles. Example: 2021Example: 1984
    TitletitleTextRequiredMovie or TV show name, or its Rotten Tomatoes link. Example: BarbieExample: Barbie
    SeasonseasonNumberOptionalTV season number; omit for the whole series. Example: 2Example: 2

    What you get

    FieldTypeDescription
    TypetypeTextExample: Movie
    YearyearNumberExample: 2023
    TitletitleTextExample: Barbie
    GenresgenresList
    RuntimeruntimeTextExample: 1h 54m
    DirectordirectorTextExample: Greta Gerwig
    Age Ratingage_ratingTextExample: PG-13
    Poster Linkposter_linkTextExample: https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p1347253…
    TomatometertomatometerNumberCritics score as a percentage.Example: 88
    Top 10 Casttop_10_castList
    PopcornmeterpopcornmeterNumberAudience score as a percentage.Example: 83
    Verified Hotverified_hotYes or noExample: No
    Us Box Officeus_box_officeNumberExample: 636200000
    Critic Reviewscritic_reviewsNumberExample: 508
    Where to Watchwhere_to_watchList
    Certified Freshcertified_freshYes or noExample: Yes
    Audience Ratingsaudience_ratingsNumberTotal audience ratings when the site provides their counts; otherwise null.Example: 18954
    Critics Consensuscritics_consensusTextExample: Barbie is a visually dazzling comedy whose meta humor is smartly complemented…
    Rotten Tomatoes Linkrotten_tomatoes_linkTextExample: https://www.rottentomatoes.com/m/barbie
    Us Box Office Currencyus_box_office_currencyTextUSD if US box office is shown.Example: USD

    Example result

    For Title: Barbie

    JSON
    {
  "type": "movie",
  "year": 2023,
  "title": "Barbie",
  "genres": [
    "Comedy"
  ],
  "runtime": "1h 54m",
  "director": "Greta Gerwig",
  "age_rating": "PG-13",
  "poster_link": "https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p13472534_p_v8_am.jpg",
  "tomatometer": 88,
  "top_10_cast": [
    "Margot Robbie",
    "Ryan Gosling",
    "America Ferrera"
  ],
  "popcornmeter": 83,
  "verified_hot": false,
  "us_box_office": 636200000,
  "critic_reviews": 508,
  "where_to_watch": [
    "Fandango",
    "HBO Max"
  ],
  "certified_fresh": true,
  "audience_ratings": 18954,
  "critics_consensus": "Barbie is a visually dazzling comedy whose meta humor is smartly complemented by subversive storytelling.",
  "rotten_tomatoes_link": "https://www.rottentomatoes.com/m/barbie",
  "us_box_office_currency": "USD"
}

    List movies

    1 credit

    List Rotten Tomatoes movies in theaters, coming soon, or at home by genre and site sort order, with scores, dates, ratings, posters, and links. Unavailable details are null.

    What you provide

    FieldTypeRequiredDescription
    ListlistTextOptionalWhich movie list to browse, for example in_theaters.Example: At home
    SortsortTextOptionalMovie order, for example highest_tomatometer.Example: Newest
    GenregenreTextOptionalA genre such as comedy, horror, or all for every genre.Example: Comedy
    Max Resultsmax_resultsNumberOptionalMaximum number of movies to return, for example 30.Example: 35

    What you get

    FieldTypeDescription
    MoviesmoviesListMovies in the selected site order.
    Titlemovies[].titleTextMovie title.Example: Teenage Sex and Death at Camp Miasma
    Age Ratingmovies[].age_ratingTextAge classification, or null if not listed.Example: R
    Poster URLmovies[].poster_urlTextPoster image link, or null if unavailable.Example: https://resizing.flixster.com/DOnk_vwgy5PympGmq8-olrMAuI4=/164x246/v2/https://r…
    Tomatometermovies[].tomatometerNumberCritics score as a percent, or null if unavailable.Example: 94
    Popcornmetermovies[].popcornmeterNumberAudience score as a percent, or null if unavailable.Example: 79
    Release Datemovies[].release_dateDateTheatrical release date, or streaming release date for at-home movies.Example: 2026-10-02
    Rotten Tomatoes URLmovies[].rotten_tomatoes_urlTextRotten Tomatoes movie page.Example: https://www.rottentomatoes.com/m/teenage_sex_and_death_at_camp_miasma

    Example result

    For List: At home, Sort: Newest, Genre: Comedy, Max Results: 35

    JSON
    {
  "movies": [
    {
      "title": "Teenage Sex and Death at Camp Miasma",
      "age_rating": "R",
      "poster_url": "https://resizing.flixster.com/DOnk_vwgy5PympGmq8-olrMAuI4=/164x246/v2/https://resizing.flixster.com/e6L--SBRx1PvceaQoUsdgmWeZqs=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzL2Q2OTE2MjRiLTI0OWMtNDE1ZC04YTQwLTg0ZmV…",
      "tomatometer": 94,
      "popcornmeter": 79,
      "release_date": "2026-10-02",
      "rotten_tomatoes_url": "https://www.rottentomatoes.com/m/teenage_sex_and_death_at_camp_miasma"
    },
    {
      "title": "Stu Plus Who?",
      "age_rating": null,
      "poster_url": "https://resizing.flixster.com/Jtn0wSxU6EbaGMXxIlGBiMoiu7Y=/164x246/v2/https://resizing.flixster.com/6O7SNpDHvlAyeerdbinn3p-Dc8M=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzJlNTIyODQ0LTY4NjYtNGE2OC1hNjUxLTdiOWR…",
      "tomatometer": null,
      "popcornmeter": null,
      "release_date": "2026-10-02",
      "rotten_tomatoes_url": "https://www.rottentomatoes.com/m/stu_plus_who"
    },
    {
      "title": "Backpay",
      "age_rating": null,
      "poster_url": "https://resizing.flixster.com/evq4KEno78hHgNmDGchtgKWJ84w=/164x246/v2/https://resizing.flixster.com/X8z-MxrM8wWzekjYc9im_0cQlc0=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzL2ZhODQ3NDQ3LTdjM2ItNGQ0OC04MmNjLTAyY2N…",
      "tomatometer": null,
      "popcornmeter": null,
      "release_date": "2026-10-02",
      "rotten_tomatoes_url": "https://www.rottentomatoes.com/m/backpay"
    }
  ]
}

    For developers

    Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

    cURL
    curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@rotten-tomatoes",
  "visibility": "public",
  "operation": "get_reviews",
  "version": 1,
  "input": {
    "title": "The Last of Us",
    "season": 1,
    "max_results": 5,
    "review_type": "audience"
  },
  "response": {
    "format": "json"
  }
}'

    What you can do with it

    Questions about Rotten Tomatoes

    Can I run it with my own inputs?

    Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

    Can I call this Rotten Tomatoes tool as an API?

    Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

    How much does it cost?

    Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

    Do I need a Rotten Tomatoes account?

    No. You only need a Fous account.

    How current is the data?

    Fous gets the data from rottentomatoes.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

    What are the critic and audience scores for a title?

    Use Get scores with the movie or TV title; optionally provide a year or season to distinguish it.

    What are critics or audiences saying about a movie?

    Use Get reviews with the title and review type to read recent reviews.

    Which movies are in theaters or coming soon?

    Use List movies and choose the movie list, genre, and sort order.

    All Entertainment toolsBrowse all tools