# Rotten Tomatoes API

> 3 public methods for Rotten Tomatoes (rottentomatoes.com), each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by Rotten Tomatoes.

- Page: https://fous.com/methods/rottentomatoes.com

## Methods

### [Get scores](https://fous.com/methods/rottentomatoes.com/get-scores.md)

`rottentomatoes.com/get_scores`, read. 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.

Returns: title, year, type, tomatometer, popcornmeter, review counts, consensus, rating, runtime, genres, director, cast, where to watch, box office, poster, link

### [List movies](https://fous.com/methods/rottentomatoes.com/list-movies.md)

`rottentomatoes.com/list_movies`, read. 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.

Returns: title, tomatometer, popcornmeter, release_date, age_rating, poster_url, rotten_tomatoes_url

### [Get reviews](https://fous.com/methods/rottentomatoes.com/get-reviews.md)

`rottentomatoes.com/get_reviews`, read. 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.

Returns: title, link, reviews (reviewer, publication, verdict, stars, text, date, link)