Metascores, user scores and every review for games, movies, TV shows and albums
- endpoints
- 38
- credits per call
- 1–2
This API reads Metacritic, logged out.
| title | age_rating | type | release_date |
|---|---|---|---|
| Batman | PG-13 | movie | 1989-06-23 |
| Batman: Arkham City | T | game | 2011-10-18 |
| Batman: Arkham Knight | M | game | 2015-06-23 |
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
Get a free API keyRun the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Metacritic API
4 of 38 endpoints, ready to run
A game's Metascore, user score, platforms and highlights
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What Metacritic endpoints does ReefAPI ship?
38 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
search
1 crMetacritic's own search over games, movies, TV shows and people, ranked by relevance or sorte…
- required
- query
- optional
- type, sort, direction, page, limit
search_counts
2 crHow many games, movies, TV shows and people match a query (one count per type, as the search…
- required
- query
- optional
- —
game_details
1 crEverything the game page shows.
- required
- —
- optional
- slug, platform
movie_details
1 crEverything the movie page shows.
- required
- —
- optional
- slug
show_details
1 crEverything the TV show page shows.
- required
- —
- optional
- slug
album_details
1 crA music album page.
- required
- —
- optional
- slug, artist
title_scores
2 crJust the two score blocks of a game, movie, show, season or album.
- required
- —
- optional
- slug, type, artist, platform, season
critic_reviews
1 crCritic reviews of a game, movie, show (or one season) or album, 10 per page (the site's fixed…
- required
- —
- optional
- slug, type, artist, platform, season, sort, sentiment, page
user_reviews
1 crUser reviews of a game, movie, show (or one season / episode) or album.
- required
- —
- optional
- slug, type, artist, platform, season, episode, sort, sentiment, page, limit
reviews_summary
2 crBoth score blocks plus the review highlights the title page shows.
- required
- —
- optional
- slug, type, artist, platform, season
related_titles
2 crThe page's related titles.
- required
- —
- optional
- slug, type, artist, sort, limit
where_to_watch
2 crWhere a movie or TV show streams, rents or sells (the page's 'Where to Watch', JustWatch US c…
- required
- —
- optional
- slug, type
where_to_buy
1 crA game's retailer prices per platform (the page's 'Where to Buy').
- required
- —
- optional
- slug
game_stats
2 crGameFAQs player statistics shown on the game page.
- required
- —
- optional
- slug
title_news
1 crNews, features and galleries Metacritic tagged with a game, movie or show, newest first.
- required
- —
- optional
- slug, type, page, limit
browse
1 crMetacritic's browse finder.
- required
- type
- optional
- sort, genre, platform, network, age_rating, year, year_min, year_max, release_type, metascore_min, metascore_max, userscore_min, userscore_max, season_view, page, limit
browse_filters
1 crEvery filter value browse accepts for one type, read live from the site's filter catalogue.
- required
- type
- optional
- —
top_rated
1 crBest-of list.
- required
- type
- optional
- year, genre, platform, network, age_rating, page, limit
new_releases
1 crNewest released titles first (the site's 'Newly Released' list).
- required
- type
- optional
- reviewed_only, genre, platform, network, age_rating, page, limit
upcoming
1 crTitles not released yet, soonest first (the site's 'Coming Soon').
- required
- type
- optional
- genre, platform, network, page, limit
in_theaters
1 crMovies now playing in US theaters, newest first or by Metascore.
- required
- —
- optional
- sort, genre, page, limit
trending
1 crThis week's trending movies or TV shows on Metacritic, each with Metascore, rating, companies…
- required
- type
- optional
- —
featured
2 crThe editorial lists on the home and section pages (their names follow the editorial calendar.
- required
- —
- optional
- section
seasons
1 crEvery season of a TV show with its Metascore block, premiere date, year and episode count.
- required
- show
- optional
- —
season_details
2 crOne TV season.
- required
- show
- optional
- season
episodes
1 crThe episode list of one season.
- required
- show
- optional
- season
episode_details
2 crOne episode.
- required
- show
- optional
- season, episode
person
2 crA cast / crew member or artist.
- required
- person
- optional
- —
person_credits
1 crA person's credits of one kind (movies, TV, games or albums).
- required
- person
- optional
- type, sort, limit, cursor
publication
1 crA critic outlet's profile.
- required
- publication
- optional
- —
publication_reviews
1 crEvery review an outlet has on Metacritic, 10 per page (fixed by the site).
- required
- publication
- optional
- type, sort, sentiment, page
critic_profile
1 crAn individual critic's profile.
- required
- critic
- optional
- —
critic_profile_reviews
1 crAn individual critic's reviews, 10 per page.
- required
- critic
- optional
- type, sort, sentiment, page
user_profile
1 crA Metacritic member's public profile.
- required
- user
- optional
- —
user_profile_reviews
1 crA member's public reviews in one category.
- required
- user
- optional
- type, sort, page, limit
news
1 crMetacritic's latest news, features, rankings and galleries.
- required
- —
- optional
- section, page, limit
news_article
2 crOne Metacritic article or gallery.
- required
- article
- optional
- —
videos
1 crThe latest trailers and clips playlist of the home page, games or movies.
- required
- —
- optional
- section
Every parameter, every allowed value →
Missing a Metacritic endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Metacritic API works
Metacritic is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a best-of list to every review of one title
Find the best-reviewed titles of a year, open one, then read what critics and users wrote.
The 487 games of 2023 with a Metascore, best first, 24 per page.
Metascore, critic review count and split, user score and rating count, every platform's own score, developers, publishers and review highlights.
The PS5 critic reviews newest first: quote, score, publication, author, date and link to the full review.
A year's ranking, one title's full score breakdown and its reviews, platform by platform.
curl -X POST https://api.reefapi.com/metacritic/v1/game_details \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"slug":"elden-ring"}'{
"ok": true,
"data": { … },
"meta": {
"api": "metacritic",
"endpoint": "game_details",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Metacritic field actually contains
Fields that read differently from how they look. Every row was measured against live Metacritic pages on 2026-11-16.
| Field | What it holds |
|---|---|
| metascore.review_count | The page's "Based on N Critic Reviews": reviews with a score. 240 of 244 checks on 24 Metacritic pages matched the page (the 4 others: albums with no user ratings yet, where the page prints "available after 4 ratings"). |
| metascore.reviews_including_unscored, critic_reviews_total | Metacritic also lists reviews without a score. Elden Ring: Metascore based on 86 reviews, 93 reviews listed ("Showing 93 Critic Reviews"); the 7 others carry a quote and a link but no score. |
| user_score.rating_count vs user_reviews_total | Ratings and written reviews are different counts: Elden Ring has 25,246 user ratings and 6,658 written user reviews. |
| positive_count, mixed_count, negative_count, *_percent | The bars under each score. Percentages are those counts over the total, rounded as the page prints them (Elden Ring users: 82% / 6% / 11%). |
| metascore.score null | Metacritic prints no Metascore until a title has enough reviews (Elden Ring on PS4: 1 review, no score). The count is still returned. |
| platform (games) | With platform, the scores and reviews cover that platform only: Elden Ring is 96 on PS5 and 94 on PC (60 reviews), user score 8.4 vs 7.6. |
| browse total | Sorting by Metascore lists titles that have one (14,464 games); sorting by date lists the whole catalogue including unreleased and unreviewed titles (186,263 games). |
| order_note | Many titles share a release date and Metacritic orders those ties differently per request. Over 4 pages of 50 games by date, 31 to 42 of 200 rows repeated. With metascore_min=1 (or new_releases) the list repeats at most 1 of 200. |
| review_url | Link to the full review on the publication's site; null when the review was published in print only. The quote is the excerpt Metacritic itself shows. |
| where_to_watch | Streaming, rent and buy offers from Metacritic's "Where to Watch" box, US catalogue. |
The Metascore is a weighted average of professional critic scores on a 0-100 scale; the user score is the average member rating on a 0-10 scale.
Metacritic coverage, measured
Every number below was read from live Metacritic pages on 2026-11-16.
580 of 580 calls answered across 38 actions: 56 title pages (games, movies, TV shows, albums), 144 review pages, 53 browse lists, 20 searches, seasons, episodes, people, publications, critics, members, news, galleries and videos.
Metascore, critic review count, user score, rating count, sentiment and positive / mixed / negative percentages matched the page on 240 of 244 checks (13 title pages, 2 album pages, 7 review pages, 2 season pages). The 4 others are albums with no user ratings yet.
Titles with a Metascore: 14,464 games, 17,454 movies, 3,482 TV shows (4,156 seasons) and 23,637 albums; 186,263 games including unreleased and unreviewed ones.
Genre (40 game, 27 film / TV, 26 music genres), 24 game platforms, 20 streaming services, age ratings, release years, coming soon, in theaters, Metascore and user score bounds, season view, seven sorts. Every filter cut the list; on the 15 filters checked row by row, all 360 first-page rows matched.
Critic reviews 10 per page with quote, score, publication, author when printed, date and link; user reviews up to 100 per page with score, username, date and spoiler flag; by platform, season or episode.
No full review text (quote and link only), no album search or coming-soon list, no track lists (the site's are empty), no thumbs-up counts on user reviews, no music filter on publication or member review lists. Lists sorted by date over the whole catalogue can repeat rows between pages because many titles share a date.
What people build with Metacritic
The jobs this data is most often used for.
Track the Metascore and user score of a game, film, series or album as reviews come in.
Collect every critic review of a title with publication, score, date and link for sentiment analysis.
Build best-of lists by year, genre, platform or streaming service with the site's own ranking.
Compare a game's scores across PS5, PC, Xbox and Switch, or a show's scores season by season.
endpoints
credits per call
What Metacritic data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 694 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/metacritic/v1/game_details \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"slug":"elden-ring"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/metacritic/v1/game_details",
headers={"x-api-key": REEF_KEY},
json={
"slug": "elden-ring"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Metacritic.
Do I need a Metacritic account?▾
No. Everything is read from Metacritic's public pages, logged out.
Does it match what metacritic.com shows?▾
On 2026-11-16 the API's Metascore, critic review count, user score, rating count, sentiment and positive / mixed / negative percentages matched the page on 240 of 244 checks across 13 title pages, 2 album pages, 7 review pages and 2 season pages. The 4 differences are albums with no user ratings yet: the page prints "available after 4 ratings" and the API returns a rating count of 0 and no score.
Can I get every review of a title?▾
Yes, page by page. Critic reviews come 10 per page (the site's own page size), user reviews up to 100 per page. Pages 1 to 3 of Elden Ring's user reviews returned 150 different reviews, and the list totals matched the page's "Showing N Reviews" on 7 of 7 review pages checked.
Can I get scores for one platform or one TV season?▾
Yes. Games take a platform (PS5, PC, Xbox Series X/S, Switch, Switch 2 and 19 more) and shows take a season number; the scores, review lists and totals then cover that platform or season.
Which filters does browse support?▾
Genre, platform (games), streaming service (movies and TV: Netflix, Prime Video, Disney+, HBO Max and 16 more), age rating, a release year or year range, coming soon, in theaters (movies), minimum and maximum Metascore, minimum and maximum user score, a season view for TV, and seven sorts. Each was measured to cut the list: for example PS5 games 1,207, Action RPG games 738, PS5 Action RPG games of 2024: 18.
Are music albums included?▾
Yes: album pages, critic reviews, browse by genre and year (23,637 albums with a Metascore), best-of lists and an artist's album credits. Metacritic has no coming-soon list and no search for albums, and none of the 10 albums sampled had user ratings yet.
Does it return the full text of critic reviews?▾
No. It returns the quote Metacritic publishes, the score, the publication, the author when printed and the link to the full review on the publication's site.
What about people and publications?▾
person returns a portrait and how many movie, TV, game and album credits Metacritic lists; person_credits pages through them. publication and critic_profile return review counts, the positive / mixed / negative split and average score; their review lists come 10 per page with the title reviewed.
What is the Metacritic API?▾
Metacritic API is a ReefAPI endpoint group for metascores and user scores for games, movies, tv shows and albums, with the positive / mixed / negative split, critic and user reviews, search, browse with every filter, best-of lists, seasons, people and publications. It returns live JSON through POST requests under /metacritic/v1.
Is the Metacritic API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Metacritic calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Metacritic login or account?▾
No login to Metacritic is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Metacritic data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Metacritic API use?▾
Metacritic actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Metacritic from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call metacritic actions with the same key, credit pool and JSON envelope used by normal REST requests.
43 Media, Film & Knowledge APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Metacritic, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.