RottenTomatoes Utility Library (custom API)

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

Script này sẽ không được không được cài đặt trực tiếp. Nó là một thư viện cho các script khác để bao gồm các chỉ thị meta // @require https://update.greasyfork.org/scripts/389810/959077/RottenTomatoes%20Utility%20Library%20%28custom%20API%29.js

Tác giả
driver8
Phiên bản
0.1.11
Đã tạo
06-09-2019
Đã cập nhật
11-08-2021
Giấy phép
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'