<p align="center"> <img src="./assets/img/logo.png" height="200" alt="Metacritic" /> </p> <p align="center"> Metacritic API is a provider of compilations on reviews of music albums, video games, movies, television shows, DVDs and books. </p> <p align="center"> <img alt="Maintenance" src="https://img.shields.io/badge/Maintained%3F-yes-blue.svg" /> <img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg" /> <img src="https://img.shields.io/badge/Metacritic-API-blue.svg"/> </p> <p align="center"> <a href="https://nodei.co/npm/unofficial-metacritic/"><img src="https://nodei.co/npm/unofficial-metacritic.png"></a> </p>

🚧 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 | |----------------------|----------|:-------------:|--------------------------------