Dieses Skript sollte nicht direkt installiert werden. Es handelt sich hier um eine Bibliothek für andere Skripte, welche über folgenden Befehl in den Metadaten eines Skriptes eingebunden wird // @require https://update.greasyfork.org/scripts/389810/959077/RottenTomatoes%20Utility%20Library%20%28custom%20API%29.js
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'
