# Metacritic API: Get scores > Finds a game, movie or TV show on Metacritic by name and returns critic and user scores with title details. Unofficial. Not affiliated with or endorsed by Metacritic. - Page: https://fous.com/methods/metacritic.com/get-scores - Method: `metacritic.com/get_scores`, version 1 - Website: metacritic.com - Returns: title, metascore, user score, review counts, release date, developer, publisher, genres, summary - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `type` | string | no | | Kind of title, for example game; omit to search all kinds. One of "game", "movie", "tv", "music". | | `year` | integer | no | | Release year to distinguish similarly named titles, for example 2022. | | `title` | string | yes | `"Elden Ring"` | Title to find, for example Elden Ring. | | `platform` | string | no | | Game platform, for example PlayStation 5; by default uses the platform with the most critic reviews. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "title": "Elden Ring" } ``` Its output: ```json { "type": "game", "title": "Elden Ring", "artist": null, "genres": [ "Action RPG" ], "summary": "A New World Created By Hidetaka Miyazaki And George R. R. Martin\n\nELDEN RING, developed by FromSoftware, Inc. and BANDAI NAMCO Entertainment Inc., is a fantasy action-RPG adventure set within a world created by Hidetaka Miyazaki creator of the influential DARK SOULS video game series; and George R.R…", "platform": "PlayStation 5", "developer": "From Software", "metascore": 96, "publisher": "Bandai Namco Games", "user_score": 8.4, "release_date": "2022-02-25", "user_ratings": 24881, "critic_reviews": 93, "metacritic_url": "https://www.metacritic.com/game/elden-ring/", "cover_image_url": "https://www.metacritic.com/a/img/resize/86c7a59722e76cf9cb2c83bfac863f18f815bc2a/catalog/provider/6/12/6-1-824956-52.jpg?auto=webp&fit=crop&height=675&width=1200", "must_play_or_see": true, "metascore_verdict": "Universal Acclaim", "studio_or_network": null } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"metacritic.com/get_scores","input":{"title":"Elden Ring"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What is the Metascore and user score for Elden Ring on PlayStation 5? - Look up the critic and user reviews for the 2019 movie Parasite on Metacritic. - Find the release date, developer and publisher for the 2022 game God of War Ragnarok. - How many critic and user reviews does the TV show Breaking Bad have, and what is its summary? - Get the genres and Metascore for the 2011 album Watch the Throne by Jay-Z and Kanye West. ## Input schema ```json { "type": "object", "required": [ "title" ], "properties": { "type": { "enum": [ "game", "movie", "tv", "music" ], "type": "string", "description": "Kind of title, for example game; omit to search all kinds." }, "year": { "type": "integer", "description": "Release year to distinguish similarly named titles, for example 2022." }, "title": { "type": "string", "description": "Title to find, for example Elden Ring." }, "platform": { "type": "string", "description": "Game platform, for example PlayStation 5; by default uses the platform with the most critic reviews." } } } ``` ## Output schema ```json { "type": "object", "required": [ "type", "metacritic_url" ], "properties": { "type": { "type": "string" }, "title": { "type": [ "string", "null" ] }, "artist": { "type": [ "string", "null" ] }, "genres": { "type": "array", "items": { "type": "string" } }, "summary": { "type": [ "string", "null" ] }, "platform": { "type": [ "string", "null" ] }, "developer": { "type": [ "string", "null" ] }, "metascore": { "type": [ "integer", "null" ] }, "publisher": { "type": [ "string", "null" ] }, "user_score": { "type": [ "number", "null" ] }, "release_date": { "type": [ "string", "null" ] }, "user_ratings": { "type": [ "integer", "null" ] }, "critic_reviews": { "type": [ "integer", "null" ] }, "metacritic_url": { "type": "string" }, "cover_image_url": { "type": [ "string", "null" ] }, "must_play_or_see": { "type": "boolean" }, "metascore_verdict": { "type": [ "string", "null" ] }, "studio_or_network": { "type": [ "string", "null" ] } } } ``` ## See more - [Metacritic API: List best-reviewed titles](https://fous.com/methods/metacritic.com/list-best-reviewed.md): Lists the highest-Metascore games, movies or TV shows on Metacritic for a release year or all time. You can filter by genre, and by platform for games. - [Rotten Tomatoes API: Get scores](https://fous.com/methods/rottentomatoes.com/get-scores.md): Gets Rotten Tomatoes critic and audience scores and title details for a movie or TV show, optionally for one TV season. Audience rating counts may be unavailable for series. - [Common Sense Media API: Get an age rating](https://fous.com/methods/commonsensemedia.org/get-age-rating.md): Finds the Common Sense Media review of a movie, TV show, game, book, app or podcast by title (optionally type and year) and returns its age rating, star rating, verdict and parents' guide. - [Rotten Tomatoes API: Get reviews](https://fous.com/methods/rottentomatoes.com/get-reviews.md): Reads the newest critic or audience reviews for a Rotten Tomatoes movie or TV show. For a whole TV show it combines reviews from its seasons. - [IMDb API: Get movie or show](https://fous.com/methods/imdb.com/get-movie-or-show.md): Gets a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null. - [themoviedb.org API: Get movie details](https://fous.com/methods/themoviedb.org/get-movie.md): Finds a movie on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country. - [Netflix API: Get movie or show](https://fous.com/methods/netflix.com/get-movie-or-show.md): Gets one Netflix movie or series by its exact name or Netflix title URL: title details, publicly shown seasons and episodes, and whether it is available in a given country's catalogue (checked against public JustWatch listings). - [Pitchfork API: Get album review](https://fous.com/methods/pitchfork.com/get-album-review.md): Finds Pitchfork's newest review that matches an album title and artist, and returns the review's rating and details. - [All Metacritic methods](https://fous.com/methods/metacritic.com.md)