RottenTomatoes Utility Library (custom API)

Utility library for Rotten Tomatoes. Provides an API for grabbing info from rottentomatoes.com

Detta skript bör inte installeras direkt. Det är ett bibliotek för andra skript att inkludera med meta-direktivet // @require https://update.greasyfork.org/scripts/389810/959077/RottenTomatoes%20Utility%20Library%20%28custom%20API%29.js

Skapare
driver8
Version
0.1.11
Skapad
2019-09-06
Uppdaterad
2021-08-11
Licens
N/A

Provides three functions:


getRtIdFromTitle(title[, tv[, year]])
Searches for a movie (or TV show) with the given title (and optionally year) and returns the RottenTomatoes ID (e.g. "/m/serenity") for the best match.
title: title of the movie or show to search for
tv: is it a TV show? (default: false)
year: year it was published (optional)



getRtInfoFromId(id):
Given a RottenTomatoes ID (e.g. "/m/serenity"), looks up that movie or TV show (returns info for the first season) and returns an object with the following properties:
id: RottenTomatoes ID (e.g. "/m/serenity")
score: Tomatometer rating (e.g. 78%)
rating: Average numerical rating from critics, out of 10
votes: Number of critics counted
consensus: Blurb describing critics' consensus
state: "rotten", "fresh, "certified_fresh", or not defined
topScore: Tomatometer rating from only "top" critics (e.g. 78%)
topRating: Average numerical rating from only "top" critics, out of 10
topVotes: Number of "top" critics counted
year: Release year according to RottenTomatoes
fetched: Date object of when data was fetched (now)



getRtInfoFromTitle(title[, tv[, year]])
Searches for a movie with the given title (and optionally year, or TV show) using getRtIdFromTitle and returns the data from getRtInfoFromId for the best match.
title: title of the movie or show to search for
tv: is it a TV show? (default: false)
year: year it was published (optional)


Examples:

Get movie info

getRtInfoFromTitle('serenity', false, 2005);

Returns:

{
  "id": "/m/serenity",
  "score": 83,
  "rating": 7.17,
  "votes": 185,
  "consensus": "Snappy dialogue and goofy characters make this Wild Wild West soap opera in space fun and adventurous.",
  "state": "certified_fresh",
  "topScore": 85,
  "topRating": 7.03,
  "topVotes": 40,
  "year": 2005,
  "fetched": "2019-09-06T02:39:37.017Z"
}

Get TV show info

getRtInfoFromTitle('my hero academia', true, 2016);

Returns:

{
  "id": "/tv/my_hero_academia",
  "score": 100,
  "rating": 8.67,
  "votes": 9,
  "consensus": null,
  "state": "fresh",
  "topScore": null,
  "topRating": null,
  "topVotes": null,
  "year": 2016,
  "fetched": "2019-09-06T02:35:29.336Z"
}

Get movie ID

getRtIdFromTitle('serenity');

Returns:

'/m/serenity'