unofficial-metacritic
v2.0.0
Published
Metacritic API is a provider of compilations on reviews of music albums, video games, movies, television shows, DVDs and books.
Downloads
15
Maintainers
chris5855Readme
🚧 Project in development
More details in the next days / months.
📖 API Documentation
getGameReviews([options: GamesParamsOptions])
| @interface | @member | @type | @values | |----------------------|----------|:-------------:|-----------------------------------------------------------------------:| | GamesParamsOptions | filterBy | string | new-releases, coming-soon, available | | | platform | string | ps5, ps4, xbox-series-x, xboxone, switch, pc, ios, stadia | | | sortBy | string | date, metascore, name, userscore |
(async () => {
const options = {
filterBy: 'new-releases',
platform: 'ps4',
sortBy: 'date'
}
await getGameReviews(options)
.then(res => console.log(JSON.stringify(res[0], null, 2)))
.catch(e => console.log(e));
})();{
"title": "Ghost of Tsushima",
"poster": "https://static.metacritic.com/images/products/games/0/260ef84455c9c9e47a0cdd2df24622bb-98.jpg",
"summary": "The year is 1274. Samurai warriors are the legendary defenders of Japan -- until the fearsome Mongol Empire invades the island of Tsushima, wreaking havoc and conquering the local population. As one of the last surviving samurai, you rise from the ashes to fight back. But, honorable tactics won't lead you to victory. You must move beyond your samurai traditions to forge a new way of fighting -- the way of the Ghost -- as you wage an unconventional war for the freedom of Japan.",
"score": 83,
"release_date": "July 17, 2020",
"platform": "PlayStation 4",
"extra": [
{
"info": [
{
"contentRating": "ESRB M",
"gamePlatform": "PlayStation 4",
"operatingSystem": "PlayStation 4",
"genre": [
"General",
"Action Adventure",
"Open-World"
],
"publisher": [
{
"@type": "Organization",
"name": "Sony Interactive Entertainment",
"url": "https://www.metacritic.com/company/sony-interactive-entertainment"
}
],
"aggregateRating": {
"@type": "AggregateRating",
"bestRating": "100",
"worstRating": "0",
"ratingValue": "83",
"ratingCount": "94"
}
}
],
"videos": [
{
"trailer": [
"https://static-gamespotvideo.cbsistatic.com/vr/2020/05/14/Breakout_GhostOfTsushima_CombatAndStealth_8000.mp4",
"https://static-gamespotvideo.cbsistatic.com/vr/2020/05/14/Breakout_GhostOfTsushima_Exploration_8000.mp4",
"https://static-gamespotvideo.cbsistatic.com/vr/2018/06/14/Trailer_GhostofTsushima_E3Japanese_20180614_4000.mp4",
"https://static-gamespotvideo.cbsistatic.com/vr/2018/06/12/Trailer_GhostTsushima_E3_20180611_4000.mp4",
"https://static-gamespotvideo.cbsistatic.com/vr/2020/05/14/Breakout_GhostOfTsushima_CustomizationAndOutro_8000.mp4",
"https://static-gamespotvideo.cbsistatic.com/vr/2020/07/16/400168/Feature_GOT8CombatTips_20200715_8000.mp4",
"https://static-gamespotvideo.cbsistatic.com/vr/2020/07/15/399354/ghost_of_tsushima_kurosawa_mode_first_9_minutes_8000.mp4",
"https://static-gamespotvideo.cbsistatic.com/vr/2020/07/15/399353/ghost_of_tsushima_shrine_discovery_and_stealth_gameplay_8000.mp4",
"https://static-gamespotvideo.cbsistatic.com/vr/2020/06/29/372837/Trailer_GhostOfTsushima_20200629_4000.mp4",
"https://static-gamespotvideo.cbsistatic.com/vr/2020/07/15/399972/Gameplay_GOTHardModeCamp_20200710_8000.mp4"
]
}
],
"reviews": [
{
"review": "Ghost of Tsushima takes the best elements of Assassins Creed and Far Cry, throws in some of the signature Sucker Punch flair that made Infamous so successful and ends up being something that is both familiar and unique at the same time. The stealth elements are not the strongest, and aside from the missions requiring stealth, I almost always took the more forward approach to combat, but the freedom to DO that is part of what makes the game so good. Sony has consistently released incredible, single player, story focused exclusives for the PS4, and Ghost of Tsushima stands tall as one of their best yet.",
"review_critic": "Gaming Age",
"review_date": "Jul 14, 2020",
"review_grade": "100"
},
{
"review": "Ghost of Tsushima is a riveting tale complemented by infinitely fascinating combat, inventive navigation mechanics, and arresting visuals, effortlessly earning itself a spot as one of the absolute best games released on the PlayStation 4.",
"review_critic": "We Got This Covered",
"review_date": "Jul 14, 2020",
"review_grade": "100"
},
{
"review": "While many of the elements here made their debuts in other games in the genre, Sucker Punch does an amazing job of weaving them together in a way that not only creates a satisfying gameplay experience but also enhances an already stellar narrative. I cannot think of a better way for Sony to send-off the generation.",
"review_critic": "ZTGD",
"review_date": "Jul 14, 2020",
"review_grade": "100"
}
// .....
]
}
]
}getMoviesReviews([options: MoviesParamsOptions])
| @interface | @member | @type | @values | |----------------------|----------|:-------------:|------------------:| | MoviesParamsOptions | year | string | [2020 - 1916] |
(async () => {
const options = {
year: '2020'
}
await getMoviesReviews(options)
.then(res => console.log(JSON.stringify(res[0], null, 2)))
.catch(e => console.log(e));
})();{
"title": "Never Rarely Sometimes Always",
"poster": "https://static.metacritic.com/images/products/movies/7/1824c3f3bcfbb9631dff46a5dd83e613-98.jpg",
"summary": "Faced with an unintended pregnancy and a lack of local support, Autumn (Sidney Flanigan) and her cousin Skylar (Talia Ryder) embark across state lines to New York City on a fraught journey of friendship, bravery and compassion",
"score": 91,
"release_date": "March 13, 2020",
"rating": "Not Rated",
"extra": [
{
"info": [
{
"aggregateRating": {
"@type": "AggregateRating",
"bestRating": "100",
"worstRating": "0",
"ratingValue": "91",
"ratingCount": "34"
},
"contentRating": "Not Rated",
"duration": "PT101M",
"actor": [
{
"@type": "Person",
"name": "Amy Tribbey",
"url": "https://www.metacritic.com/person/amy-tribbey"
},
{
"@type": "Person",
"name": "Aurora Richards",
"url": "https://www.metacritic.com/person/aurora-richards"
},
{
"@type": "Person",
"name": "Brett Puglisi",
"url": "https://www.metacritic.com/person/brett-puglisi"
}
// .....
],
"publisher": [
{
"@type": "Organization",
"name": "Focus Features",
"url": "https://www.metacritic.com/company/focus-features"
}
],
"genre": [
"Drama"
]
}
],
"videos": {
"trailer": "https://video.internetvideoarchive.net/video.mp4?cmd=6&fmt=4&customerid=654126&publishedid=633964&e=2208902400&videokbrate=1500&h=053ef63e783fd35b96c4cae49e0d995c"
},
"reviews": [
{
"author": "Ann Hornaday",
"review_critic": "Washington Post",
"review_date": "Apr 1, 2020",
"review_grade": "100",
"review": "With empathy and outrage that cut equally deeply, Hittman reminds us: This is a girl’s life in a man’s world."
},
{
"author": "Ty Burr",
"review_critic": "Boston Globe",
"review_date": "Apr 1, 2020",
"review_grade": "100",
"review": "The performance of Flanagan, a first-time actress, is both harrowing and possessed of an eloquence that has no need for words. You come away from this movie weeping for the Autumns of this world but awed by their endurance."
},
{
"author": "Manohla Dargis",
"review_critic": "The New York Times",
"review_date": "Mar 12, 2020",
"review_grade": "100",
"review": "In “Never Rarely,” the hurdles to an abortion are as legion as they are maddening and pedestrian, a blunt political truism that Hittman brilliantly connects to women’s fight for emancipation."
}
// .....
]
}
]
}getTVReviews([options: TVParamsOptions])
| @interface | @member | @type | @values | |----------------------|----------|:-------------:|---------------------------------------------:| | TVParamsOptions | filterBy | string | new-series, special-event, returning-series | | | sortBy | string | date, metascore, name, userscore |
(async () => {
const options = {
filterBy: 'new-series',
sortBy: 'date'
}
await getTVReviews(options)
.then(res => console.log(JSON.stringify(res[0], null, 2)))
.catch(e => console.log(e));
})();{
"title": "Love Fraud: Season 1",
"poster": "https://static.metacritic.com/images/products/tv/2/1fce01360441a2ecabe94f05b235b098-98.jpg",
"summary": "The four-part documentary series from Rachel Grady and Heidi Ewing follows the victims defrauded by conman Richard Scott Smith as they band together to seek justice by finding him before he steals another woman's money and disappears again.",
"score": null,
"release_date": "August 30, 2020",
"extra": [
{
"info": [
{
"numberOfEpisodes": "4",
"publisher": [
{
"@type": "Organization",
"name": "SHOWTIME",
"url": "https://www.metacritic.com/company/showtime"
}
],
"genre": [
"Movie/Mini-Series",
"Documentary"
],
"episode": [
{
"@type": "TVEpisode",
"name": "Episode 4",
"url": "https://www.metacritic.com/tv/love-fraud/season-1/episode-4-episode-4-1048046",
"episodeNumber": "4",
"description": "",
"datePublished": "November 30, -0001"
},
{
"@type": "TVEpisode",
"name": "Episode 3",
"url": "https://www.metacritic.com/tv/love-fraud/season-1/episode-3-episode-3-1048045",
"episodeNumber": "3",
"description": "",
"datePublished": "November 30, -0001"
},
{
"@type": "TVEpisode",
"name": "Episode 2",
"url": "https://www.metacritic.com/tv/love-fraud/season-1/episode-2-episode-2-1048044",
"episodeNumber": "2",
"description": "",
"datePublished": "November 30, -0001"
},
{
"@type": "TVEpisode",
"name": "Episode 1",
"url": "https://www.metacritic.com/tv/love-fraud/season-1/episode-1-episode-1-1048043",
"episodeNumber": "1",
"description": "",
"datePublished": "November 30, -0001"
}
]
}
],
"reviews": [
{
"review": "Excellent. ... Ewing and Grady deftly slide back and forth between the history of Smith and the immediate hunt to find him. What results is a remarkable momentum that builds up as you get angrier and angrier at this loathsome human being and become more involved in his capture.",
"review_critic": "RogerEbert.com",
"author": "Brian Tallerico",
"review_date": "Jan 28, 2020",
"review_grade": "90"
},
{
"review": "It starts off in a lot of places that seem familiar, but every time you become too complacent in your expectations, Love Fraud detours and the resulting series is sad, distressing and filled with enough Midwestern weirdness for a Coen Brothers movie.",
"review_critic": "The Hollywood Reporter",
"author": "Dan Fienberg",
"review_date": "Jan 24, 2020",
"review_grade": "70"
}
]
}
]
}getMusicReviews([options: MusicParamsOptions])
| @interface | @member | @type | @values | |----------------------|----------|:-------------:|---------------------------------------------:| | MusicParamsOptions | filterBy | string | new-releases, available | | | sortBy | string | date, metascore, name, userscore |
(async () => {
const options = {
filterBy: 'new-releases',
sortBy: 'date'
}
await getMusicReviews(options)
.then(res => console.log(JSON.stringify(res[0], null, 2)))
.catch(e => console.log(e));
})();{
"title": "Gaslighter",
"poster": "https://static.metacritic.com/images/products/music/0/10e06538a7d484d2cd9e41a6b869b1c3-98.jpg",
"summary": "The first new studio album in 14 years for the country trio formerly known as the Dixie Chicks was produced with Jack Antonoff.",
"score": 86,
"release_date": "July 17, 2020",
"extra": {
"reviews": [
{
"review": "Stunning. ... With slick, tasteful production from Jack Antanoff built around shining guitars and perfectly balanced vocal arrangements, this is a powerful addition to the genre.",
"review_critic": "The Telegraph (UK)",
"review_date": "Jul 16, 2020",
"review_grade": "100"
},
{
"review": "By blending early-21st-century pop savvy with the storytelling that made country music so crucial to the American canon, Gaslighter is all fire and nerve, performed by three women whose musical bona fides are rivaled only by their rock-solid backbones.",
"review_critic": "Entertainment Weekly",
"review_date": "Jul 13, 2020",
"review_grade": "100"
},
{
"review": "Rather than impose an excess of ear candy (although it’s welcome on the few occasions in which it comes), Antonoff knew what he had on his hands here: an album in which each new incendiary lyrical moment seems to top the last, before grievance gives way to beautiful grief. Candor, take them away.",
"review_critic": "Variety",
"review_date": "Jul 16, 2020",
"review_grade": "93"
},
{
"review": "The management of tone throughout is also masterful and consistent. For all the shifting that occurs within individual songs, it’s always anchored to place by restrained instrumentation and artful, deliberate counterpoints between highs and lows.",
"review_critic": "Consequence of Sound",
"review_date": "Jul 17, 2020",
"review_grade": "91"
}
// .....
]
}
}getUpcomingAlbumReleases()
UPCOMING ALBUM RELEASE CALENDAR All dates are for U.S. releases unless otherwise noted. Release dates are subject to change, and often do.
ANTICIPATED FUTURE RELEASES These albums do not yet have a firm release date, but are in various stages of development. If an artist appears multiple times, that means multiple albums by that artist are forthcoming
(async () => {
await getUpcomingAlbumReleases()
.then(res => console.log(JSON.stringify(res, null, 2)))
.catch(e => console.log(e));
})();[
{
"upcoming_album": [
{
"artist_name": null,
"album_title": null,
"extra": null
},
{
"artist_name": "Courtney Marie Andrews",
"album_title": "Old Flowers",
"extra": [
{
"album_title": "May Your Kindness Remain",
"metascore": "79",
"year": "Mar 23, 2018",
"role": "Primary Artist",
"user_score": "6.5"
},
{
"album_title": "Honest Life",
"metascore": "82",
"year": "Aug 19, 2016",
"role": "Primary Artist",
"user_score": "tbd"
}
]
}
// .....
],
"anticipated_album": [
{
"artist_name": "Adele",
"album_title": "[Title TBA]",
"extra": [
{
"album_title": "25",
"metascore": "75",
"year": "Nov 20, 2015",
"role": "Primary Artist",
"user_score": "7.6"
},
{
"album_title": "Live at the Royal Albert Hall",
"metascore": "76",
"year": "Nov 29, 2011",
"role": "Primary Artist",
"user_score": "7.9"
},
{
"album_title": "21",
"metascore": "76",
"year": "Feb 22, 2011",
"role": "Primary Artist",
"user_score": "8.1"
},
{
"album_title": "19",
"metascore": "68",
"year": "Jun 10, 2008",
"role": "Primary Artist",
"user_score": "7.7"
}
]
}
// .....
]
}
]:handshake: Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request
Donations
Metacritic API is an open source project licensed by MIT with continuous development. If you want me to continue maintaining this library and you are interested in continuing to use it, you can help me with a monetary help in the following link:
These are projects that take a lot of effort and time to maintain. So with your help I will be more motivated to continue maintaining the Metacritic API project.
:busts_in_silhouette: Credits
- Chris Michael (Project Leader, and Developer)
:anger: Troubleshootings
This is just a personal project created for study / demonstration purpose and to simplify my working life, it may or may not be a good fit for your project(s).
:heart: Show your support
Please :star: this repository if you like it or this project helped you!
Feel free to open issues or submit pull-requests to help me improving my work.
:robot: Author
Chris Michael
Copyright © 2020 Metacritic.