Rotten Tomatoes Scraper

ENDPOINTS
GET/ratings

Ratings Lookup

Get the Tomatometer and Popcornmeter of any movie or show by name, slug or URL, plus Certified Fresh / Verified Hot.

QUERY PARAMS

The title to look up: free text, a Rotten Tomatoes slug or any rottentomatoes.com title URL. Free text resolves to the closest search hit (is_exact_match tells you if it matched exactly).

Examples:

  • Text: Avengers: Endgame
  • Slug: avengers_endgame
  • URL: https://www.rottentomatoes.com/m/avengers_endgame

Release year, to disambiguate remakes and same-name titles when title is free text.

Allowed values: 1870-2100

Restrict a free-text lookup to movies or TV shows.

Allowed values: movie, tv

{
  "query": "Avengers: Endgame",
  "is_exact_match": true,
  "ems_id": "7b2bcd9a-359f-3ffd-bbbd-abe9e5ce3f9e",
  "rt_id": 771432224,
  "type": "movie",
  "title": "Avengers: Endgame",
  "slug": "avengers_endgame",
  "link": "https://www.rottentomatoes.com/m/avengers_endgame",
  "year": 2019,
  "content_rating": "PG-13",
  "genres": [
    "Action",
    "Adventure",
    "Fantasy",
    "Sci-Fi"
  ],
  "runtime_minutes": 181,
  "poster_link": "https://resizing.flixster.com/hu13NxX2cqnYsnL7vDtkOoq7Z-A=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzQwYTA0ZmQyLTEzZmMtNGIwMS1hNDdjLTE3NWIwOTY2MzNkYi5qcGc=",
  "tomatometer": 94,
  "popcornmeter": 90,
  "is_certified_fresh": true,
  "is_verified_hot": false,
  "critics_score": {
    "score": 94,
    "sentiment": "positive",
    "is_certified_fresh": true,
    "certified_date": null
  },
  "audience_score": {
    "score": 90,
    "sentiment": "positive",
    "is_verified_hot": false,
    "want_to_see_count": 34943
  }
}