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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Type optional
type Kind of title, for example game; omit to search all kinds.
Not set
One of
game,movie,tv,music.- Year optional
year Release year to distinguish similarly named titles, for example 2022.
Not set
Whole number.
- Title, required
title Title to find, for example Elden Ring.
Elden Ring
- Platform optional
platform Game platform, for example PlayStation 5; by default uses the platform with the most critic reviews.
Not set
Input as JSON
{ "title": "Elden Ring"}Output
{ "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}Code
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"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "metacritic.com/get_scores" , "input": { "title": "Elden Ring" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "metacritic.com/get_scores" , "input": { "title": "Elden Ring" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run metacritic.com/get_scores# with {"title":"Elden Ring"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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" ] } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
metacritic.com/get_scores- Returns
- title, metascore, user score, review counts, release date, developer, publisher, genres, summary
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method metacritic.com/get_scores with the inputs above.
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.
See more
All Metacritic methodsLists 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.
metacritic.com/list_best_reviewedGets 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.
rottentomatoes.com/get_scoresFinds 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.
commonsensemedia.org/get_age_ratingReads 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.
rottentomatoes.com/get_reviewsGets 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.
imdb.com/get_movie_or_showFinds 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.
themoviedb.org/get_movieGets 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).
netflix.com/get_movie_or_showFinds Pitchfork's newest review that matches an album title and artist, and returns the review's rating and details.
pitchfork.com/get_album_review