RottenTomatoes Utility Library (custom API)

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

Dette script bør ikke installeres direkte. Det er et bibliotek, som andre scripts kan inkludere med metadirektivet // @require https://update.greasyfork.org/scripts/389810/959077/RottenTomatoes%20Utility%20Library%20%28custom%20API%29.js

Skaber
driver8
Version
0.1.11
Oprettet
06.09.2019
Opdateret
11.08.2021
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'