OpenCritic API

Every game OpenCritic scores, with every critic review behind the number

endpoints
29
credits per call
0–2

This API reads OpenCritic, the video game review aggregator, as JSON, logged out.

POST/opencritic/v1/search
Real result, captured Nov 16, 20263 of 10
nametypedistanceexact
Tia Zellcritic0.75false
Tristan Zeldencritic0.76false
Zero Zero Zero Zerogame0.78false
29 active endpoints, on 0, 1 and 2 credit tiers.game · search · browse · game_reviews · game_reviews_all · featured_reviews+23 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.

OpenCritic API

5 of 29 endpoints, ready to run

View docs ↗

A game's scores, rating and details

1 credit1 required · 0 optional
POST/opencritic/v1/game
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 OpenCritic endpoints does ReefAPI ship?

29 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • game

    1 cr

    One game's full OpenCritic record.

    required
    game
    optional
    full_media
  • search

    1 cr

    Search OpenCritic by name.

    required
    query
    optional
    type
  • browse

    1 cr

    Browse every game on OpenCritic with the filters of the site's /browse page.

    required
    —
    optional
    platform, period, year, tag, sort, order, page
  • game_reviews

    1 cr

    A game's critic reviews, 20 per page, in the site's six orders.

    required
    game
    optional
    sort, page
  • game_reviews_all

    2 cr

    Every critic review of a game in one call (no paging), optionally only Top Critic reviews.

    required
    game
    optional
    top_critics_only
  • featured_reviews

    1 cr

    The critic reviews OpenCritic features on the game's page (8 on a reviewed game).

    required
    game
    optional
    —
  • score_distribution

    2 cr

    How a game's critics scored it (the site's charts tab), computed over the complete review set.

    required
    game
    optional
    —
  • user_rating

    1 cr

    A game's OpenCritic user rating.

    required
    game
    optional
    —
  • user_reviews

    1 cr

    A game's approved OpenCritic user reviews, up to 100 per page, by score or newest.

    required
    game
    optional
    sort, page, per_page
  • game_news

    2 cr

    News articles OpenCritic links to a game, with the article text OpenCritic publishes.

    required
    game
    optional
    —
  • popular

    1 cr

    The games most popular on OpenCritic right now (the site's 'Popular' list.

    required
    —
    optional
    —
  • upcoming

    1 cr

    The major upcoming releases the site lists in its sidebar (a short list.

    required
    —
    optional
    —
  • recently_released

    1 cr

    The major recently released games the site lists (8).

    required
    —
    optional
    —
  • reviewed_today

    1 cr

    Games that received the most reviews today, with the count (recent_review_count).

    required
    —
    optional
    —
  • reviewed_this_week

    1 cr

    Games that received the most reviews this week, with the count.

    required
    —
    optional
    —
  • deals

    1 cr

    Games currently discounted at OpenCritic's partner stores, with the featured deal (store, pri…

    required
    —
    optional
    —
  • hall_of_fame

    1 cr

    OpenCritic's Hall of Fame.

    required
    —
    optional
    year
  • calendar

    1 cr

    The site's release calendar.

    required
    —
    optional
    —
  • outlets

    0 cr

    Every outlet (publication) OpenCritic aggregates, with review count, median / average score,…

    required
    —
    optional
    query, language, top_critics_only, sort, page, per_page
  • outlet

    1 cr

    One outlet's OpenCritic profile.

    required
    outlet
    optional
    —
  • outlet_reviews

    1 cr

    Reviews published by an outlet, 20 per page, in the site's sort orders.

    required
    outlet
    optional
    sort, page
  • critic

    1 cr

    One critic's OpenCritic profile.

    required
    critic
    optional
    —
  • critic_reviews

    1 cr

    Reviews written by a critic, 20 per page, in the site's sort orders.

    required
    critic
    optional
    sort, page
  • news

    1 cr

    OpenCritic's news feed, newest first, 10 per page.

    required
    —
    optional
    page
  • news_article

    1 cr

    One OpenCritic news article with the text OpenCritic publishes.

    required
    article
    optional
    —
  • collections

    0 cr

    The subscription catalogues OpenCritic tracks (Xbox Game Pass Ultimate / Xbox / PC …).

    required
    —
    optional
    —
  • collection

    1 cr

    One subscription catalogue.

    required
    collection
    optional
    —
  • collection_games

    2 cr

    The games of a subscription catalogue as full game records, 20 per page, by score or release…

    required
    collection
    optional
    sort, page
  • reference

    0 cr

    The site's reference lists.

    required
    —
    optional
    kind

Every parameter, every allowed value →

Missing a OpenCritic endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the OpenCritic API works

OpenCritic 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 /opencritic/v1/…

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

Pay03
0 or 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 platform and a year to the reviews behind each score

Browse with OpenCritic's filters, open the games you want, then read what the critics wrote.

01browse?platform=ps5&year=2025&tag=rpg
GET/opencritic/v1/browse?platform=ps5&year=2025&tag=rpg

PS5 RPGs of 2025, best Top Critic Average first, 20 per page: id, name, release date, Top Critic Average, Critics Recommend %, rating, review count, platforms and tags.

02game?game=<id>
GET/opencritic/v1/game?game=<id>

The game page's numbers (Top Critic Average, Critics Recommend %, Mighty / Strong / Fair / Weak, percentile) plus developers, publishers, platforms with release dates, stores and trailers.

03game_reviews_all?game=<id>&top_critics_only=true
GET/opencritic/v1/game_reviews_all?game=<id>&top_critics_only=true

Every Top Critic review in one call: outlet, critic, score on the outlet's own scale, quote, date and link.

04score_distribution?game=<id>
GET/opencritic/v1/score_distribution?game=<id>

How the critics split: counts per score, 10-point buckets, min / max / mean / median for all reviews and for top critics.

A dated list where every game carries OpenCritic's numbers and the critic reviews that produced them.

request
curl -X POST https://api.reefapi.com/opencritic/v1/game \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"game":"14343"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "opencritic",
    "endpoint": "game",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What an OpenCritic field actually contains

Fields that read differently from how they look. Every row was measured against live opencritic.com on 2026-11-16.

FieldWhat it holds
top_critic_average, top_critic_scoretop_critic_average is the number in the game page's "Top Critic Average" circle (rounded); top_critic_score is the unrounded value behind it. Matched the page on 11 of 11 scored games checked the same minute.
critics_recommend, percent_recommendedcritics_recommend is the page's "Critics Recommend" percentage (rounded); percent_recommended is unrounded. Matched the page on 10 of 10 games that show it.
opencritic_ratingOpenCritic's Mighty / Strong / Fair / Weak tier. Null while a game has too few reviews; the scores are then null too, never -1.
review_count, top_critic_review_countAll critic reviews OpenCritic lists for the game, and those from Top Critic outlets. review_count matched the page on 11 of 11 games that print it.
score, score_original, score_displayscore is OpenCritic's 0-100 normalisation; score_original is the critic's own value (10.0, 4.5, "A-", "Recommended") and score_display is how the review list prints it ("9 / 10", "4.5 / 5 stars"). Outlet, critic, score and Top Critic badge matched the review list on 120 of 120 rows across 7 games.
quoteThe excerpt OpenCritic itself publishes for the review. The full review stays on the outlet's site (review_url).
is_top_criticThe "Top Critic" badge: the review comes from an outlet OpenCritic counts as a top critic. Zelda: Tears of the Kingdom had 108 such reviews of 168, the record's own top-critic count.
platforms[].release_dateEach platform's own release date. With a platform, browse's year filter uses that date: Switch + 2024 includes games first released in 2022 and ported in 2024.
on_opencritic (collection_games)Game Pass catalogues also list titles OpenCritic does not review; they come with a name and release date and on_opencritic false (67 of 459 rows in Game Pass PC).

Scores, recommend percentages and review counts were compared with the game page as opencritic.com rendered it in the same minute (12 games, 32 values, 0 mismatches).

Coverage

OpenCritic coverage, measured

Every number below was read from live opencritic.com on 2026-11-16.

Games

20,296 games in browse, every page reachable (20 per page, last page 1,015). The 2026 release calendar lists 349 games.

Critic reviews

Every review a game has, in six orders: Zelda: Tears of the Kingdom 168 of 168 in each order with no repeats, 108 of them Top Critic reviews.

Accuracy

Top Critic Average, Critics Recommend % and review count matched the game page on 12 games in the same minute (32 values, 0 mismatches); outlet, critic, score and Top Critic badge matched the review list on 120 of 120 rows.

Outlets and critics

838 outlets (177 Top Critic outlets, 29 German-language), each with review count, median and average score and percent recommended; critic profiles with bio and social handles.

Lists

Hall of Fame 2016 to 2026 (12 games per year), popular (49), deals (24), reviewed today and this week (10 each), recently released (8), Xbox Game Pass Ultimate, Xbox and PC catalogues.

Limits

Browse and review lists give no total count (use has_more; a game's review_count is its total). Upcoming is a short list of major releases (2 on 2026-11-16); browse with period=upcoming has every upcoming game. Reviews without a verdict carry no score. The full review text stays on the outlet's site.

Use cases

What people build with OpenCritic

The jobs this data is most often used for.

01

Show the Top Critic Average, Critics Recommend % and Mighty / Strong / Fair / Weak rating next to every game in a store or wishlist.

02

Track how a new release's review score develops in the first days after the embargo, review by review.

03

Compare outlets or critics: how harshly each scores, how often they recommend, on which platforms.

04

Build year-end and genre rankings from browse (year, platform, tag) and the Hall of Fame.

29

endpoints

0/1/2

credits per call

Pricing

What OpenCritic data costs

The cheapest call here is 0 credits, 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/opencritic/v1/game \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"game":"14343"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/opencritic/v1/game",
    headers={"x-api-key": REEF_KEY},
    json={
        "game": "14343"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up OpenCritic.

Do I need an OpenCritic account?▾

No. Everything is read logged out, as any visitor sees opencritic.com.

Can I get every critic review of a game?▾

Yes. game_reviews pages through them 20 at a time in any of the site's six orders, and game_reviews_all returns the whole set in one call. Zelda: Tears of the Kingdom: 168 reviews, all 168 reached in every order with no repeats.

Does it give the critic's original score or only the 0-100 number?▾

Both: score (0-100 as OpenCritic normalises it), score_original on the outlet's scale and score_display as the site prints it, for example "9 / 10", "4.5 / 5 stars" or a verdict such as "Recommended". Reviews without a verdict have no score (66 of 1,829 sampled).

Which browse filters are there?▾

The ones on OpenCritic's browse page: platform (PC, PS5, PS4, Xbox Series X/S, Xbox One, Switch, Switch 2, Meta Quest, PS VR, Vive, Wii U, 3DS, Vita, Stadia), release year, last 90 days, upcoming, tag (RPG, Souls-like, Open World and 36 more), sorted by score, release date, name, review count or Critics Recommend %, ascending or descending.

How deep does browse go?▾

20 games per page and every page answers: unfiltered, 20,296 games on 2026-11-16, the last on page 1,015. OpenCritic gives no total count for browse, so has_more tells you whether another page follows.

Can I get the Hall of Fame?▾

Yes, for every year from 2016 to the current one: 12 games per year (2025: Hades II first).

Does it include outlets and critics?▾

Yes. outlets lists all 838 outlets OpenCritic aggregates (177 of them Top Critic outlets) with review counts, median and average scores and percent recommended; outlet and critic return one profile, and outlet_reviews and critic_reviews every review they published.

How fresh is the data?▾

Every call reads opencritic.com live.

What is the OpenCritic API?▾

OpenCritic API is a ReefAPI endpoint group for video game critic scores as opencritic prints them (top critic average, critics recommend, mighty / strong / fair / weak), every critic review with its quote and score, hall of fame, browse and outlet / critic profiles. It returns live JSON through POST requests under /opencritic/v1.

Is the OpenCritic API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. OpenCritic calls use the same shared credit balance as every other ReefAPI engine.

Do I need an OpenCritic login or account?▾

No login to OpenCritic 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 OpenCritic data?▾

The page example is captured from a live game call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the OpenCritic API use?▾

OpenCritic 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 OpenCritic from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call opencritic 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 OpenCritic, 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.