Metacritic API

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.

POST/metacritic/v1/search
Real result, captured Nov 16, 20263 of 30
titleage_ratingtyperelease_date
BatmanPG-13movie1989-06-23
Batman: Arkham CityTgame2011-10-18
Batman: Arkham KnightMgame2015-06-23
38 active endpoints, on 1 and 2 credit tiers.search · search_counts · game_details · movie_details · show_details · album_details+32 more ↓OpenAPI 3.0 spec ↗

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run 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

View docs ↗

A game's Metascore, user score, platforms and highlights

1 credit1 required · 1 optional
POST/metacritic/v1/game_details
idle
// 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.

Try every endpoint in the playground

Endpoints

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 cr

    Metacritic'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 cr

    How many games, movies, TV shows and people match a query (one count per type, as the search…

    required
    query
    optional
    —
  • game_details

    1 cr

    Everything the game page shows.

    required
    —
    optional
    slug, platform
  • movie_details

    1 cr

    Everything the movie page shows.

    required
    —
    optional
    slug
  • show_details

    1 cr

    Everything the TV show page shows.

    required
    —
    optional
    slug
  • album_details

    1 cr

    A music album page.

    required
    —
    optional
    slug, artist
  • title_scores

    2 cr

    Just the two score blocks of a game, movie, show, season or album.

    required
    —
    optional
    slug, type, artist, platform, season
  • critic_reviews

    1 cr

    Critic 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 cr

    User 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 cr

    Both score blocks plus the review highlights the title page shows.

    required
    —
    optional
    slug, type, artist, platform, season
  • related_titles

    2 cr

    The page's related titles.

    required
    —
    optional
    slug, type, artist, sort, limit
  • where_to_watch

    2 cr

    Where 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 cr

    A game's retailer prices per platform (the page's 'Where to Buy').

    required
    —
    optional
    slug
  • game_stats

    2 cr

    GameFAQs player statistics shown on the game page.

    required
    —
    optional
    slug
  • title_news

    1 cr

    News, features and galleries Metacritic tagged with a game, movie or show, newest first.

    required
    —
    optional
    slug, type, page, limit
  • browse

    1 cr

    Metacritic'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 cr

    Every filter value browse accepts for one type, read live from the site's filter catalogue.

    required
    type
    optional
    —
  • top_rated

    1 cr

    Best-of list.

    required
    type
    optional
    year, genre, platform, network, age_rating, page, limit
  • new_releases

    1 cr

    Newest released titles first (the site's 'Newly Released' list).

    required
    type
    optional
    reviewed_only, genre, platform, network, age_rating, page, limit
  • upcoming

    1 cr

    Titles not released yet, soonest first (the site's 'Coming Soon').

    required
    type
    optional
    genre, platform, network, page, limit
  • in_theaters

    1 cr

    Movies now playing in US theaters, newest first or by Metascore.

    required
    —
    optional
    sort, genre, page, limit
  • trending

    1 cr

    This week's trending movies or TV shows on Metacritic, each with Metascore, rating, companies…

    required
    type
    optional
    —
  • featured

    2 cr

    The editorial lists on the home and section pages (their names follow the editorial calendar.

    required
    —
    optional
    section
  • seasons

    1 cr

    Every season of a TV show with its Metascore block, premiere date, year and episode count.

    required
    show
    optional
    —
  • season_details

    2 cr

    One TV season.

    required
    show
    optional
    season
  • episodes

    1 cr

    The episode list of one season.

    required
    show
    optional
    season
  • episode_details

    2 cr

    One episode.

    required
    show
    optional
    season, episode
  • person

    2 cr

    A cast / crew member or artist.

    required
    person
    optional
    —
  • person_credits

    1 cr

    A person's credits of one kind (movies, TV, games or albums).

    required
    person
    optional
    type, sort, limit, cursor
  • publication

    1 cr

    A critic outlet's profile.

    required
    publication
    optional
    —
  • publication_reviews

    1 cr

    Every review an outlet has on Metacritic, 10 per page (fixed by the site).

    required
    publication
    optional
    type, sort, sentiment, page
  • critic_profile

    1 cr

    An individual critic's profile.

    required
    critic
    optional
    —
  • critic_profile_reviews

    1 cr

    An individual critic's reviews, 10 per page.

    required
    critic
    optional
    type, sort, sentiment, page
  • user_profile

    1 cr

    A Metacritic member's public profile.

    required
    user
    optional
    —
  • user_profile_reviews

    1 cr

    A member's public reviews in one category.

    required
    user
    optional
    type, sort, page, limit
  • news

    1 cr

    Metacritic's latest news, features, rankings and galleries.

    required
    —
    optional
    section, page, limit
  • news_article

    2 cr

    One Metacritic article or gallery.

    required
    article
    optional
    —
  • videos

    1 cr

    The 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 it works

How the Metacritic API works

Metacritic is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /metacritic/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

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.

01top_rated?type=game&year=2023
GET/metacritic/v1/top_rated?type=game&year=2023

The 487 games of 2023 with a Metascore, best first, 24 per page.

02game_details?slug=baldurs-gate-3
GET/metacritic/v1/game_details?slug=baldurs-gate-3

Metascore, critic review count and split, user score and rating count, every platform's own score, developers, publishers and review highlights.

03baldurs-gate-3&platform=ps5&sort=date
GET/metacritic/v1/critic_reviews?slug=game/baldurs-gate-3&platform=ps5&sort=date

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.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "metacritic",
    "endpoint": "game_details",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
metascore.review_countThe 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_totalMetacritic 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_totalRatings 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, *_percentThe 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 nullMetacritic 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 totalSorting 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_noteMany 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_urlLink 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_watchStreaming, 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.

Coverage

Metacritic coverage, measured

Every number below was read from live Metacritic pages on 2026-11-16.

Calls

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.

Accuracy

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.

Catalogue

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.

Filters

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.

Reviews

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.

Limits

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.

Use cases

What people build with Metacritic

The jobs this data is most often used for.

01

Track the Metascore and user score of a game, film, series or album as reviews come in.

02

Collect every critic review of a title with publication, score, date and link for sentiment analysis.

03

Build best-of lists by year, genre, platform or streaming service with the site's own ranking.

04

Compare a game's scores across PS5, PC, Xbox and Switch, or a show's scores season by season.

38

endpoints

1/2

credits per call

Pricing

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.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
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"}'
python
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"])
FAQ

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.

Same key

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.

Contact

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.

0/4000

No account needed · we reply from [email protected]

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.