# OpenCritic API — video game critic scores (Top Critic Average, Critics Recommend, Mighty/Strong/Fair/Weak), every critic review, Hall of Fame, browse, outlets and critics

> One game's full OpenCritic record: Top Critic Average, Critics Recommend %, OpenCritic Rating (Mighty / Strong / Fair / Weak), percentile, median score, review and top-critic review counts, description, platforms with per-platform release dates, developers, publishers, genres, tags, age rating, OpenCritic's pros/cons summary, stores with prices, box art / masthead / screenshots, trailers and the review-date milestones. `full_media` adds every screenshot and trailer (the site's media tab).
> ReefAPI engine `opencritic` · 29 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/opencritic/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/opencritic/v1/game — 1 credit
One game's full OpenCritic record: Top Critic Average, Critics Recommend %, OpenCritic Rating (Mighty / Strong / Fair / Weak), percentile, median score, review and top-critic review counts, description, platforms with per-platform release dates, developers, publishers, genres, tags, age rating, OpenCritic's pros/cons summary, stores with prices, box art / masthead / screenshots, trailers and the review-date milestones. `full_media` adds every screenshot and trailer (the site's media tab).

**Parameters:**
- `game` (string, required) — The game: its OpenCritic id (`14343`), an opencritic.com game link, or its exact name (`Elden Ring`; a name that is not an exact match returns the closest names instead).
- `full_media` (boolean, optional, default false) — Every screenshot and trailer, as on the game's media tab.

**Returns:** id, name, url, top_critic_average (the page's 'Top Critic Average', rounded), top_critic_score (unrounded), critics_recommend (the page's 'Critics Recommend' %, rounded), percent_recommended, opencritic_rating (Mighty|Strong|Fair|Weak), percentile, median_score, review_count, top_critic_review_count, description, first_release_date, platforms[]{id, name, short_name, release_date, display_release, image}, genres[]{id, name}, tags[]{id, name}, developers[], publishers[], companies[]{name, role}, age_rating, review_summary{summary, set_at, points[]{text, kind}}, is_major_title, is_pre_2015, has_loot_boxes, stores[]{name, url, price, base_price}, biggest_discount_dollars, biggest_discount_percent, images{box, square, masthead, banner, logo, screenshots[]}, legacy_images, trailers[]{title, video_id, url, channel_title, published_date, …}, youtube_channel, dates{embargo, first_review, tenth_review, latest_review, critical_review, added_to_opencritic, updated}

**Example request body:**
```json
{
  "game": "14343"
}
```

### POST https://api.reefapi.com/opencritic/v1/search — 1 credit
Search OpenCritic by name: games, outlets (publications) and critics, closest first, as the site's search box (10 hits; `distance` 0 = exact).

**Parameters:**
- `query` (string, required) — Name or part of it (`zelda`, `ign`, `tom marks`).
- `type` (enum, optional, default "all") — all (default), game, outlet, critic. [one of: all, game, outlet, critic]

**Returns:** query, type, count, rows[]{type (game|outlet|critic), id, name, url, distance, exact}

**Example request body:**
```json
{
  "query": "zelda"
}
```

### POST https://api.reefapi.com/opencritic/v1/browse — 1 credit
Browse every game on OpenCritic with the filters of the site's /browse page: platform, release year or last 90 days or upcoming, tag (genre-style tags such as rpg, souls-like), sorted by score, release date, name, review count or percent recommended, ascending or descending. 20 games per page; no total upstream (`has_more`); unfiltered, the catalogue held 20,296 games on 2026-11-16 and every page up to the last (page 1015) answered.

**Parameters:**
- `platform` (array, optional) — pc, ps5, ps4, xbxs, xb1, switch, switch-2, quest, psvr, vive, wii-u, 3ds, vita, stadia (or the platform's name). Several = games on any of them.
- `period` (enum, optional, default "all_time") — all_time (default), last_90_days, upcoming — or use `year`. [one of: all_time, last_90_days, upcoming]
- `year` (integer, optional) — Released in this year. With a platform it is that platform's release year (a 2022 game ported to Switch in 2024 is in platform=switch, year=2024).
- `tag` (string, optional) — A tag id from `reference` kind=tags (`rpg`, `open-world`, `souls-like`) or its name.
- `sort` (enum, optional, default "score") — score (default; Top Critic Average), release_date, name, review_count, percent_recommended. [one of: score, release_date, name, review_count, percent_recommended]
- `order` (enum, optional) — desc or asc (default: the site's own direction for the sort). [one of: desc, asc]
- `page` (integer, optional, default 1) — Page, 1-based; 20 rows per page (the site's window).

**Returns:** page, per_page (20), has_more, applied{}, count, rows[]{id, name, url, first_release_date, top_critic_average, top_critic_score, critics_recommend, percent_recommended, opencritic_rating, review_count, platforms[], genres[], tags[], images{box, banner} — each list carries the keys its source row has}

**Example request body:**
```json
{
  "platform": "ps5",
  "year": 2025
}
```

### POST https://api.reefapi.com/opencritic/v1/game_reviews — 1 credit
A game's critic reviews, 20 per page, in the site's six orders: outlet, critic(s), normalized score and the critic's own score on the outlet's scale, the quote OpenCritic publishes, date, link to the full review, Top Critic badge. Page past the end → 0 rows; the total is the game's `review_count`.

**Parameters:**
- `game` (string, required) — The game: its OpenCritic id (`14343`), an opencritic.com game link, or its exact name (`Elden Ring`; a name that is not an exact match returns the closest names instead).
- `sort` (enum, optional, default "blend") — blend (default — the site's 'Default' mix), newest, oldest, score_high, score_low, popularity ('Most Popular'). [one of: blend, newest, oldest, score_high, score_low, popularity]
- `page` (integer, optional, default 1) — Page, 1-based; 20 rows per page (the site's window).

**Returns:** game{id}, page, per_page, has_more, sort, count, rows[]{id, game{id, name, url}, outlet{id, name, url, logo}, is_top_critic, authors[]{id, name, url, image}, title, quote, score (0-100, as OpenCritic normalizes it), score_original (the critic's own value or verdict), score_display ('9 / 10', '4.5 / 5 stars', 'Recommended'), score_format{…}, np_score, published_date, review_url, review_url_hidden_on_site, language, platforms[], alias, median_at_time_of_review, is_chosen, is_quote_manual, override_recommendation, youtube_video_id, created_at, updated_at}

**Example request body:**
```json
{
  "game": "14343"
}
```

### POST https://api.reefapi.com/opencritic/v1/game_reviews_all — 2 credits
Every critic review of a game in one call (no paging), optionally only Top Critic reviews.

**Parameters:**
- `game` (string, required) — The game: its OpenCritic id (`14343`), an opencritic.com game link, or its exact name (`Elden Ring`; a name that is not an exact match returns the closest names instead).
- `top_critics_only` (boolean, optional, default false) — Only reviews from Top Critic outlets.

**Returns:** game{id, name, url}, total, top_critic_count, top_critics_only, count, rows[]{id, game{id, name, url}, outlet{id, name, url, logo}, is_top_critic, authors[]{id, name, url, image}, title, quote, score (0-100, as OpenCritic normalizes it), score_original (the critic's own value or verdict), score_display ('9 / 10', '4.5 / 5 stars', 'Recommended'), score_format{…}, np_score, published_date, review_url, review_url_hidden_on_site, language, platforms[], alias, median_at_time_of_review, is_chosen, is_quote_manual, override_recommendation, youtube_video_id, created_at, updated_at}

**Example request body:**
```json
{
  "game": "14343"
}
```

### POST https://api.reefapi.com/opencritic/v1/featured_reviews — 1 credit
The critic reviews OpenCritic features on the game's page (8 on a reviewed game).

**Parameters:**
- `game` (string, required) — The game: its OpenCritic id (`14343`), an opencritic.com game link, or its exact name (`Elden Ring`; a name that is not an exact match returns the closest names instead).

**Returns:** game{id}, count, rows[]{id, game{id, name, url}, outlet{id, name, url, logo}, is_top_critic, authors[]{id, name, url, image}, title, quote, score (0-100, as OpenCritic normalizes it), score_original (the critic's own value or verdict), score_display ('9 / 10', '4.5 / 5 stars', 'Recommended'), score_format{…}, np_score, published_date, review_url, review_url_hidden_on_site, language, platforms[], alias, median_at_time_of_review, is_chosen, is_quote_manual, override_recommendation, youtube_video_id, created_at, updated_at}

**Example request body:**
```json
{
  "game": "14343"
}
```

### POST https://api.reefapi.com/opencritic/v1/score_distribution — 2 credits
How a game's critics scored it (the site's charts tab), computed over the complete review set: counts per score, 10-point buckets, scored / unscored, min / max / mean / median for all reviews and for Top Critics only.

**Parameters:**
- `game` (string, required) — The game: its OpenCritic id (`14343`), an opencritic.com game link, or its exact name (`Elden Ring`; a name that is not an exact match returns the closest names instead).

**Returns:** game{id, name, url}, review_count, scored_count, unscored_count, top_critic_review_count, all{count, min, max, mean, median}, top_critics{…}, by_score{score: count}, buckets[]{from, to, count}

**Example request body:**
```json
{
  "game": "14343"
}
```

### POST https://api.reefapi.com/opencritic/v1/user_rating — 1 credit
A game's OpenCritic user rating: median user score, how many users rated it and how many wrote a review.

**Parameters:**
- `game` (string, required) — The game: its OpenCritic id (`14343`), an opencritic.com game link, or its exact name (`Elden Ring`; a name that is not an exact match returns the closest names instead).

**Returns:** game{id}, median_user_score, rating_count, user_review_count

**Example request body:**
```json
{
  "game": "14343"
}
```

### POST https://api.reefapi.com/opencritic/v1/user_reviews — 1 credit
A game's approved OpenCritic user reviews, up to 100 per page, by score or newest: user, score on the user's chosen scale, recommend, hours played, excerpt, dates. The total is `user_review_count` from `user_rating`.

**Parameters:**
- `game` (string, required) — The game: its OpenCritic id (`14343`), an opencritic.com game link, or its exact name (`Elden Ring`; a name that is not an exact match returns the closest names instead).
- `sort` (enum, optional, default "score") — score (default) or newest. [one of: score, newest]
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 20) — Reviews per page, 1-100 (default 20; the site's maximum is 100).

**Returns:** game{id}, page, per_page, has_more, sort, count, rows[]{id, user{id, name, slug}, review_url, score, score_original, score_display, score_format_id, recommend, recommend_to[], hours_played, excerpt, status, count, created_at, updated_at}

**Example request body:**
```json
{
  "game": "14343"
}
```

### POST https://api.reefapi.com/opencritic/v1/game_news — 2 credits
News articles OpenCritic links to a game, with the article text OpenCritic publishes.

**Parameters:**
- `game` (string, required) — The game: its OpenCritic id (`14343`), an opencritic.com game link, or its exact name (`Elden Ring`; a name that is not an exact match returns the closest names instead).

**Returns:** game{id}, count, rows[]{id, title, url, teaser, description, type, outlet{id, name}, author, original_url, published_date, related_games[], image{}, body_text, body_html}

**Example request body:**
```json
{
  "game": "14343"
}
```

### POST https://api.reefapi.com/opencritic/v1/popular — 1 credit
The games most popular on OpenCritic right now (the site's 'Popular' list; 49 on 2026-11-16).

**Parameters:** none

**Returns:** count, rows[]{id, name, url, first_release_date, top_critic_average, top_critic_score, critics_recommend, percent_recommended, opencritic_rating, review_count, platforms[], genres[], tags[], images{box, banner} — each list carries the keys its source row has}

### POST https://api.reefapi.com/opencritic/v1/upcoming — 1 credit
The major upcoming releases the site lists in its sidebar (a short list; `browse` with period=upcoming has every upcoming game).

**Parameters:** none

**Returns:** count, rows[]{id, name, url, first_release_date, top_critic_average, top_critic_score, critics_recommend, percent_recommended, opencritic_rating, review_count, platforms[], genres[], tags[], images{box, banner} — each list carries the keys its source row has}

### POST https://api.reefapi.com/opencritic/v1/recently_released — 1 credit
The major recently released games the site lists (8).

**Parameters:** none

**Returns:** count, rows[]{id, name, url, first_release_date, top_critic_average, top_critic_score, critics_recommend, percent_recommended, opencritic_rating, review_count, platforms[], genres[], tags[], images{box, banner} — each list carries the keys its source row has}

### POST https://api.reefapi.com/opencritic/v1/reviewed_today — 1 credit
Games that received the most reviews today, with the count (`recent_review_count`).

**Parameters:** none

**Returns:** count, rows[]{id, name, url, first_release_date, top_critic_average, top_critic_score, critics_recommend, percent_recommended, opencritic_rating, review_count, platforms[], genres[], tags[], images{box, banner} — each list carries the keys its source row has}

### POST https://api.reefapi.com/opencritic/v1/reviewed_this_week — 1 credit
Games that received the most reviews this week, with the count.

**Parameters:** none

**Returns:** count, rows[]{id, name, url, first_release_date, top_critic_average, top_critic_score, critics_recommend, percent_recommended, opencritic_rating, review_count, platforms[], genres[], tags[], images{box, banner} — each list carries the keys its source row has}

### POST https://api.reefapi.com/opencritic/v1/deals — 1 credit
Games currently discounted at OpenCritic's partner stores, with the featured deal (store, price, base price, link) and the discount %.

**Parameters:** none

**Returns:** count, rows[]{id, name, url, first_release_date, top_critic_average, top_critic_score, critics_recommend, percent_recommended, opencritic_rating, review_count, platforms[], genres[], tags[], images{box, banner} — each list carries the keys its source row has}, featured_deal{store, price, base_price, url}, biggest_discount_percent

### POST https://api.reefapi.com/opencritic/v1/hall_of_fame — 1 credit
OpenCritic's Hall of Fame: the best-reviewed games of a year (2016 onwards; default = the current Hall of Fame year).

**Parameters:**
- `year` (integer, optional) — 2016 to the current year; empty = current.

**Returns:** year, count, rows[]{id, name, url, first_release_date, top_critic_average, top_critic_score, critics_recommend, percent_recommended, opencritic_rating, review_count, platforms[], genres[], tags[], images{box, banner} — each list carries the keys its source row has}

**Example request body:**
```json
{
  "year": 2025
}
```

### POST https://api.reefapi.com/opencritic/v1/calendar — 1 credit
The site's release calendar: every game dated in the calendar window (this year).

**Parameters:** none

**Returns:** title, tagline, start_date, end_date, game_count, events[], games[]{id, name, url, release_date, box_art}

### POST https://api.reefapi.com/opencritic/v1/outlets — 0 credits
Every outlet (publication) OpenCritic aggregates, with review count, median / average score, % recommended, score format and Top Critic status; filter by name / domain, language, Top Critic only; sort; 1-100 per page.

**Parameters:**
- `query` (string, optional) — Part of the outlet's name or domain.
- `language` (string, optional) — Review language code (`en-us`, `de-de`, `es-es` …).
- `top_critics_only` (boolean, optional) — Only Top Critic outlets.
- `sort` (enum, optional, default "review_count") — review_count (default), name, median_score, average_score, percent_recommended. [one of: review_count, name, median_score, average_score, percent_recommended]
- `page` (integer, optional, default 1) — Page, 1-based; 20 rows per page (the site's window).
- `per_page` (integer, optional, default 50) — Outlets per page, 1-100 (default 50).

**Returns:** total, page, per_page, total_pages, has_more, applied{}, count, rows[]{id, name, url, domain, website, logo{}, language, is_top_critic, is_contributor, review_count, median_score, average_score, percent_recommended, recommended_cutoff, score_format{}, is_youtube, no_longer_publishing, review_listing_urls[], news_feeds[], …}

**Example request body:**
```json
{
  "page": 1
}
```

### POST https://api.reefapi.com/opencritic/v1/outlet — 1 credit
One outlet's OpenCritic profile: review count, median / average score, % recommended, its recommendation cutoff, score format, language, Top Critic status, website.

**Parameters:**
- `outlet` (string, required) — The outlet (publication): its OpenCritic id (`56`), an opencritic.com outlet link, or its exact name (`IGN`).

**Returns:** id, name, url, domain, website, logo{}, language, is_top_critic, review_count, median_score, average_score, percent_recommended, recommended_cutoff, uses_fixed_cutoff, score_format{}, …

**Example request body:**
```json
{
  "outlet": "56"
}
```

### POST https://api.reefapi.com/opencritic/v1/outlet_reviews — 1 credit
Reviews published by an outlet, 20 per page, in the site's sort orders.

**Parameters:**
- `outlet` (string, required) — The outlet (publication): its OpenCritic id (`56`), an opencritic.com outlet link, or its exact name (`IGN`).
- `sort` (enum, optional, default "blend") — blend (default — the site's 'Default' mix), newest, oldest, score_high, score_low, popularity ('Most Popular'). [one of: blend, newest, oldest, score_high, score_low, popularity]
- `page` (integer, optional, default 1) — Page, 1-based; 20 rows per page (the site's window).

**Returns:** outlet{id}, page, per_page, has_more, sort, count, rows[]{id, game{id, name, url}, outlet{id, name, url, logo}, is_top_critic, authors[]{id, name, url, image}, title, quote, score (0-100, as OpenCritic normalizes it), score_original (the critic's own value or verdict), score_display ('9 / 10', '4.5 / 5 stars', 'Recommended'), score_format{…}, np_score, published_date, review_url, review_url_hidden_on_site, language, platforms[], alias, median_at_time_of_review, is_chosen, is_quote_manual, override_recommendation, youtube_video_id, created_at, updated_at}

**Example request body:**
```json
{
  "outlet": "56"
}
```

### POST https://api.reefapi.com/opencritic/v1/critic — 1 credit
One critic's OpenCritic profile: bio, hometown, website and social handles, favourite games, review count, median / average score, % recommended.

**Parameters:**
- `critic` (string, required) — The critic: OpenCritic id (`723`), an opencritic.com critic link, or the exact name (`Tom Marks`).

**Returns:** id, name, url, image{}, bio, hometown, website, twitter, facebook, steam, xbox_live, psn, nintendo_friend_code, favorite_games[], claimed, review_count, median_score, average_score, percent_recommended, created_at, updated_at

**Example request body:**
```json
{
  "critic": "723"
}
```

### POST https://api.reefapi.com/opencritic/v1/critic_reviews — 1 credit
Reviews written by a critic, 20 per page, in the site's sort orders.

**Parameters:**
- `critic` (string, required) — The critic: OpenCritic id (`723`), an opencritic.com critic link, or the exact name (`Tom Marks`).
- `sort` (enum, optional, default "blend") — blend (default — the site's 'Default' mix), newest, oldest, score_high, score_low, popularity ('Most Popular'). [one of: blend, newest, oldest, score_high, score_low, popularity]
- `page` (integer, optional, default 1) — Page, 1-based; 20 rows per page (the site's window).

**Returns:** critic{id}, page, per_page, has_more, sort, count, rows[]{id, game{id, name, url}, outlet{id, name, url, logo}, is_top_critic, authors[]{id, name, url, image}, title, quote, score (0-100, as OpenCritic normalizes it), score_original (the critic's own value or verdict), score_display ('9 / 10', '4.5 / 5 stars', 'Recommended'), score_format{…}, np_score, published_date, review_url, review_url_hidden_on_site, language, platforms[], alias, median_at_time_of_review, is_chosen, is_quote_manual, override_recommendation, youtube_video_id, created_at, updated_at}

**Example request body:**
```json
{
  "critic": "723"
}
```

### POST https://api.reefapi.com/opencritic/v1/news — 1 credit
OpenCritic's news feed, newest first, 10 per page.

**Parameters:**
- `page` (integer, optional, default 1) — Page, 1-based; 10 articles per page.

**Returns:** page, per_page (10), has_more, count, rows[]{id, title, url, teaser, description, type, outlet{id, name}, author, original_url, published_date, related_games[], image{}}

### POST https://api.reefapi.com/opencritic/v1/news_article — 1 credit
One OpenCritic news article with the text OpenCritic publishes.

**Parameters:**
- `article` (string, required) — Article id (`39824`) or an opencritic.com news link.

**Returns:** id, title, url, teaser, description, type, outlet{}, author, authors[], original_url, published_date, related_games[], image{}, body_text, body_html

**Example request body:**
```json
{
  "article": "39824"
}
```

### POST https://api.reefapi.com/opencritic/v1/collections — 0 credits
The subscription catalogues OpenCritic tracks (Xbox Game Pass Ultimate / Xbox / PC …): key and name.

**Parameters:** none

**Returns:** count, rows[]{key, name}

### POST https://api.reefapi.com/opencritic/v1/collection — 1 credit
One subscription catalogue: description, how many of its games are Mighty / Strong / Fair / Weak / not rated, every game in it, and the titles OpenCritic does not track.

**Parameters:**
- `collection` (string, required) — Catalogue key from `collections` (`xbox-game-pass-ultimate`) or its name.

**Returns:** key, name, description, description_html, categories[], metrics{games, mighty, strong, fair, weak, not_rated, not_on_opencritic, recent}, games[]{id, name, url}, games_not_on_opencritic[]{name, release_date}, updated_at

**Example request body:**
```json
{
  "collection": "xbox-game-pass-ultimate"
}
```

### POST https://api.reefapi.com/opencritic/v1/collection_games — 2 credits
The games of a subscription catalogue as full game records, 20 per page, by score or release date; titles in the catalogue that OpenCritic does not track are listed with their name and release date.

**Parameters:**
- `collection` (string, required) — Catalogue key or name.
- `sort` (enum, optional, default "score") — score (default) or release_date. [one of: score, release_date]
- `page` (integer, optional, default 1) — Page, 1-based; 20 rows per page (the site's window).

**Returns:** collection{key, name}, total (the catalogue's game count), total_pages, page, per_page, has_more, sort, count, rows[] (same shape as `game`, plus on_opencritic; titles OpenCritic does not track come as {id: null, name, first_release_date, on_opencritic: false})

**Example request body:**
```json
{
  "collection": "xbox-game-pass-ultimate"
}
```

### POST https://api.reefapi.com/opencritic/v1/reference — 0 credits
The site's reference lists: platforms (with the `browse` filter value), genres, tags (with the `browse` tag id) and review score formats (scales and verdict labels).

**Parameters:**
- `kind` (enum, optional, default "all") — all (default), platforms, genres, tags, score_formats. [one of: all, platforms, genres, tags, score_formats]

**Returns:** platforms[]{id, name, short_name, filter_value, order, image}, genres[]{id, name}, tags[]{id, name, description, popularity}, score_formats[]{id, name, short_name, scale, base, decimals, is_stars, is_verdict, verdicts[]}

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=opencritic
- Human docs page: https://reefapi.com/docs/opencritic
- Overview page: https://reefapi.com/opencritic-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
