# Metacritic API — Metascores, user scores, critic and user reviews for games, movies, TV shows and music albums; search, browse with every filter, best-of lists, seasons, people, publications, news

> Metacritic's own search over games, movies, TV shows and people, ranked by relevance or sorted by Metascore, release date or review count. Each row: id, type, title, slug, url, release date, Metascore, age rating, genres, platforms (games), description, duration, season count (TV), image. Up to 100 per page; `total` is the site's own hit count. Music albums are not in the site's search index — use `browse` with type album.
> ReefAPI engine `metacritic` · 38 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/metacritic/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/metacritic/v1/search — 1 credit
Metacritic's own search over games, movies, TV shows and people, ranked by relevance or sorted by Metascore, release date or review count. Each row: id, type, title, slug, url, release date, Metascore, age rating, genres, platforms (games), description, duration, season count (TV), image. Up to 100 per page; `total` is the site's own hit count. Music albums are not in the site's search index — use `browse` with type album.

**Parameters:**
- `query` (string, required) — Search text.
- `type` (enum, optional, default "all") — all, game, movie, show or person. [one of: all, game, movie, show, person]
- `sort` (enum, optional, default "relevance") — relevance, metascore, release_date or review_count. [one of: relevance, metascore, release_date, review_count]
- `direction` (enum, optional, default "desc") — desc (highest / newest first) or asc, for the non-relevance sorts. [one of: desc, asc]
- `page` (integer, optional, default 1) — Page number (1-based).
- `limit` (integer, optional, default 30) — Results per page (1-100, default 30).

**Returns:** query, type, sort, direction, total, page, limit, total_pages, has_more, count, results[]{id, type, title, slug, url, release_date, release_year, metascore{score, reviews_url}, age_rating, genres[], platforms[], description, duration_minutes, season_count, must_play/must_see/must_watch, image_url}

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

### POST https://api.reefapi.com/metacritic/v1/search_counts — 2 credits
How many games, movies, TV shows and people match a query (one count per type, as the search page's tabs show them), plus their sum.

**Parameters:**
- `query` (string, required) — Search text.

**Returns:** query, counts{all, game, movie, show, person}

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

### POST https://api.reefapi.com/metacritic/v1/game_details — 1 credit
Everything the game page shows: Metascore block (score, critic review count as printed, positive / mixed / negative counts and %, sentiment), user score block (score, rating count, split), every platform with its own Metascore and release date, lead platform, developers, publishers, genres, ESRB rating, release date, summary, franchises, regions, images, trailer, critic and user review highlights, related games, related news, retailer prices per platform and GameFAQs player stats (ratings, play time, difficulty). With `platform` the score blocks cover that platform.

**Parameters:**
- `slug` (string, optional) — The game: slug (elden-ring), 'game/elden-ring', a metacritic.com game link, or the numeric id from search.
- `platform` (string, optional) — Games only: one platform (PS5, PC, Xbox Series X/S, Switch, Switch 2, PS4, Xbox One… name, slug or id). The scores / reviews then cover that platform only; default is the game's lead platform.

**Returns:** product fields (id, title, slug, url, description, release_date, release_year, age_rating, genres, developers, publishers, companies[], lead_platform, platforms[]{name, slug, release_date, is_lead_platform, metascore{…}}, franchises, countries, images[], video, awards[]), metascore{score, review_count, positive/mixed/negative_count + _percent, sentiment}, user_score{score, rating_count, …}, critic_reviews_total, user_reviews_total, critic_highlights{featured[], positive[], mixed[], negative[]}, user_highlights{…}, related_titles[], related_news[], where_to_buy[], player_stats

**Example request body:**
```json
{
  "slug": "elden-ring"
}
```

### POST https://api.reefapi.com/metacritic/v1/movie_details — 1 credit
Everything the movie page shows: Metascore block, user score block, cast (with character), crew (director, writers, producers…), production companies, genres, MPAA rating, runtime, release date, tagline, summary, keywords, awards (wins / nominations per event), IMDb id, images, trailer, where to watch (streaming / rent / buy, US), critic and user review highlights, related movies and news.

**Parameters:**
- `slug` (string, optional) — The movie: slug (oppenheimer), 'movie/oppenheimer', a metacritic.com movie link, or the numeric id from search.

**Returns:** product fields + cast[], crew[], production_companies, imdb_id, in_theaters, awards[], metascore{…}, user_score{…}, critic_reviews_total, user_reviews_total, critic_highlights, user_highlights, where_to_watch{flatrate[], rent[], buy[], free[]…}, related_titles[], related_news[]

**Example request body:**
```json
{
  "slug": "oppenheimer"
}
```

### POST https://api.reefapi.com/metacritic/v1/show_details — 1 credit
Everything the TV show page shows: Metascore block (whole show), user score block, every season with its own Metascore and episode count, network, cast, crew, genres, TV rating, episode runtime, premiere date, summary, awards, IMDb id, where to watch (US), review highlights, related shows and news.

**Parameters:**
- `slug` (string, optional) — The show: slug (severance), 'tv/severance', a metacritic.com TV link, or the numeric id from search.

**Returns:** product fields + season_count, seasons[]{season, url, release_year, premiere_date, episode_count, metascore{…}}, networks[], cast[], crew[], metascore, user_score, where_to_watch, critic_highlights, user_highlights, related_titles[], related_news[]

**Example request body:**
```json
{
  "slug": "severance"
}
```

### POST https://api.reefapi.com/metacritic/v1/album_details — 1 credit
A music album page: Metascore block, user score block, artist(s), record label, genres, release date, summary, cover, track list (when the site has one), critic and user review highlights, other releases by the artist and related albums.

**Parameters:**
- `slug` (string, optional) — The album: its link (https://www.metacritic.com/music/dopamine-chamber/fontaines-dc/), 'music/<album>/<artist>', or the album slug with `artist`.
- `artist` (string, optional) — Albums only: the artist slug (from browse rows or the album link /music/<album>/<artist>/).

**Returns:** product fields + artists[], artist_slug, record_labels, metascore, user_score, tracks[], critic_highlights, user_highlights, other_releases[], related_titles[]

**Example request body:**
```json
{
  "slug": "dopamine-chamber"
}
```

### POST https://api.reefapi.com/metacritic/v1/title_scores — 2 credits
Just the two score blocks of a game, movie, show, season or album: Metascore (score, critic review count as printed, positive / mixed / negative) and user score (score, rating count, split). Games take `platform`, shows take `season`.

**Parameters:**
- `slug` (string, optional) — The title: a metacritic.com link (https://www.metacritic.com/game/elden-ring/), 'game/elden-ring', 'movie/oppenheimer', 'tv/severance', 'music/<album>/<artist>', or the bare slug with `type`. Movies and shows also take the numeric id from search; games by id are followed to their slug.
- `type` (enum, optional) — game, movie, show (TV) or album (music). Not needed when `slug` is a metacritic.com link or 'game/<slug>' form. [one of: game, movie, show, album]
- `artist` (string, optional) — Albums only: the artist slug (from browse rows or the album link /music/<album>/<artist>/).
- `platform` (string, optional) — Games only: one platform (PS5, PC, Xbox Series X/S, Switch, Switch 2, PS4, Xbox One… name, slug or id). The scores / reviews then cover that platform only; default is the game's lead platform.
- `season` (integer, optional) — TV only: the season number. A /tv/<show>/season-N/ link carries it.

**Returns:** type, slug, url, platform, season, metascore{…}, user_score{…}

**Example request body:**
```json
{
  "slug": "game/elden-ring"
}
```

### POST https://api.reefapi.com/metacritic/v1/critic_reviews — 1 credit
Critic reviews of a game, movie, show (or one season) or album, 10 per page (the site's fixed page size): the quote Metacritic publishes, score, publication, author, date and the link to the full review. Sort by score, date or publication; filter positive / mixed / negative; games by platform. The list includes reviews without a score (score null), so `total` can exceed the Metascore's review count.

**Parameters:**
- `slug` (string, optional) — The title: a metacritic.com link (https://www.metacritic.com/game/elden-ring/), 'game/elden-ring', 'movie/oppenheimer', 'tv/severance', 'music/<album>/<artist>', or the bare slug with `type`. Movies and shows also take the numeric id from search; games by id are followed to their slug.
- `type` (enum, optional) — game, movie, show (TV) or album (music). Not needed when `slug` is a metacritic.com link or 'game/<slug>' form. [one of: game, movie, show, album]
- `artist` (string, optional) — Albums only: the artist slug (from browse rows or the album link /music/<album>/<artist>/).
- `platform` (string, optional) — Games only: one platform (PS5, PC, Xbox Series X/S, Switch, Switch 2, PS4, Xbox One… name, slug or id). The scores / reviews then cover that platform only; default is the game's lead platform.
- `season` (integer, optional) — TV only: the season number. A /tv/<show>/season-N/ link carries it.
- `sort` (enum, optional, default "score") — score (highest first), date (newest first) or publication (A-Z). [one of: score, date, publication]
- `sentiment` (enum, optional, default "all") — all, positive, mixed or negative (the site's own filter tabs). [one of: all, positive, mixed, negative]
- `page` (integer, optional, default 1) — Page number (1-based).

**Returns:** type, slug, url, platform, season, sort, sentiment, total, page, total_pages, has_more, count, reviews[]{quote, score, publication, publication_slug, publication_url, author, author_slug, author_url, date, review_url, platform}

**Example request body:**
```json
{
  "slug": "movie/oppenheimer"
}
```

### POST https://api.reefapi.com/metacritic/v1/user_reviews — 1 credit
User reviews of a game, movie, show (or one season / episode) or album: quote, score (0-10), username, date, spoiler flag, platform. Sort by score or date; filter positive / mixed / negative; games by platform. Up to 100 per page.

**Parameters:**
- `slug` (string, optional) — The title: a metacritic.com link (https://www.metacritic.com/game/elden-ring/), 'game/elden-ring', 'movie/oppenheimer', 'tv/severance', 'music/<album>/<artist>', or the bare slug with `type`. Movies and shows also take the numeric id from search; games by id are followed to their slug.
- `type` (enum, optional) — game, movie, show (TV) or album (music). Not needed when `slug` is a metacritic.com link or 'game/<slug>' form. [one of: game, movie, show, album]
- `artist` (string, optional) — Albums only: the artist slug (from browse rows or the album link /music/<album>/<artist>/).
- `platform` (string, optional) — Games only: one platform (PS5, PC, Xbox Series X/S, Switch, Switch 2, PS4, Xbox One… name, slug or id). The scores / reviews then cover that platform only; default is the game's lead platform.
- `season` (integer, optional) — TV only: the season number. A /tv/<show>/season-N/ link carries it.
- `episode` (string, optional) — Episode number in the season, or its slug (episode-1-hello-ms-cobel).
- `sort` (enum, optional, default "date") — date (newest first) or score (highest first). [one of: date, score]
- `sentiment` (enum, optional, default "all") — all, positive, mixed or negative (the site's own filter tabs). [one of: all, positive, mixed, negative]
- `page` (integer, optional, default 1) — Page number (1-based).
- `limit` (integer, optional, default 20) — Reviews per page (1-100, default 20).

**Returns:** type, slug, url, platform, season, episode, sort, sentiment, total, page, limit, total_pages, has_more, count, reviews[]{id, quote, score, author, author_url, date, spoiler, thumbs_up, thumbs_down, platform}

**Example request body:**
```json
{
  "slug": "tv/severance"
}
```

### POST https://api.reefapi.com/metacritic/v1/reviews_summary — 2 credits
Both score blocks plus the review highlights the title page shows — featured, positive, mixed and negative critic quotes and user quotes — for a game (optionally one platform), movie, show (or one season) or album.

**Parameters:**
- `slug` (string, optional) — The title: a metacritic.com link (https://www.metacritic.com/game/elden-ring/), 'game/elden-ring', 'movie/oppenheimer', 'tv/severance', 'music/<album>/<artist>', or the bare slug with `type`. Movies and shows also take the numeric id from search; games by id are followed to their slug.
- `type` (enum, optional) — game, movie, show (TV) or album (music). Not needed when `slug` is a metacritic.com link or 'game/<slug>' form. [one of: game, movie, show, album]
- `artist` (string, optional) — Albums only: the artist slug (from browse rows or the album link /music/<album>/<artist>/).
- `platform` (string, optional) — Games only: one platform (PS5, PC, Xbox Series X/S, Switch, Switch 2, PS4, Xbox One… name, slug or id). The scores / reviews then cover that platform only; default is the game's lead platform.
- `season` (integer, optional) — TV only: the season number. A /tv/<show>/season-N/ link carries it.

**Returns:** type, slug, url, platform, season, metascore, user_score, critic_reviews_total, user_reviews_total, critic_highlights{featured[], positive[], mixed[], negative[]}, user_highlights{…}

**Example request body:**
```json
{
  "slug": "game/elden-ring"
}
```

### POST https://api.reefapi.com/metacritic/v1/related_titles — 2 credits
The page's related titles: for games, movies and shows the same type in the title's lead genre (the 'Related' carousel: best Metascore first, newest or most popular); for albums the site's related albums and the artist's other releases.

**Parameters:**
- `slug` (string, optional) — The title: a metacritic.com link (https://www.metacritic.com/game/elden-ring/), 'game/elden-ring', 'movie/oppenheimer', 'tv/severance', 'music/<album>/<artist>', or the bare slug with `type`. Movies and shows also take the numeric id from search; games by id are followed to their slug.
- `type` (enum, optional) — game, movie, show (TV) or album (music). Not needed when `slug` is a metacritic.com link or 'game/<slug>' form. [one of: game, movie, show, album]
- `artist` (string, optional) — Albums only: the artist slug (from browse rows or the album link /music/<album>/<artist>/).
- `sort` (enum, optional, default "metascore") — metascore (Top Critics' Picks), newest (New Releases) or popularity (Most Popular). [one of: metascore, newest, popularity]
- `limit` (integer, optional, default 24) — Titles per page (1-100, default 24).

**Returns:** type, slug, url, genre, sort, total, count, titles[] (rows as in browse), other_releases[] (albums)

**Example request body:**
```json
{
  "slug": "game/elden-ring"
}
```

### POST https://api.reefapi.com/metacritic/v1/where_to_watch — 2 credits
Where a movie or TV show streams, rents or sells (the page's 'Where to Watch', JustWatch US catalogue): provider, monetization (flatrate / rent / buy / free / ads), quality, price, link.

**Parameters:**
- `slug` (string, optional) — The title: a metacritic.com link (https://www.metacritic.com/game/elden-ring/), 'game/elden-ring', 'movie/oppenheimer', 'tv/severance', 'music/<album>/<artist>', or the bare slug with `type`. Movies and shows also take the numeric id from search; games by id are followed to their slug.
- `type` (enum, optional) — game, movie or show (TV). Not needed when `slug` is a metacritic.com link. [one of: game, movie, show]

**Returns:** type, slug, url, title, imdb_id, has_offers, flatrate[], rent[], buy[], free[], ads[] {provider, provider_id, provider_icon, link, monetization, number_of_seasons, options[]{quality, price, currency, offer_type}}

**Example request body:**
```json
{
  "slug": "game/elden-ring"
}
```

### POST https://api.reefapi.com/metacritic/v1/where_to_buy — 1 credit
A game's retailer prices per platform (the page's 'Where to Buy'): retailer, lowest price, original and discounted price in USD, discount %, purchase type, link.

**Parameters:**
- `slug` (string, optional) — The game: slug, 'game/<slug>' or link.

**Returns:** slug, url, title, count, platforms[]{platform, retailers[]{retailer, lowest_price{price_usd, original_price_usd, discounted_price_usd, discount_percent, purchase_type, link, expires}, options[]}}

**Example request body:**
```json
{
  "slug": "elden-ring"
}
```

### POST https://api.reefapi.com/metacritic/v1/game_stats — 2 credits
GameFAQs player statistics shown on the game page: player ratings (Unplayable … Flawless), play time, difficulty and completion status distributions, with the GameFAQs link.

**Parameters:**
- `slug` (string, optional) — The game: slug, 'game/<slug>' or link.

**Returns:** slug, url, title, family_id, stats{game_name, platform, gamefaqs_url, ratings[]{label, total}, play_time[], difficulty[], …}

**Example request body:**
```json
{
  "slug": "elden-ring"
}
```

### POST https://api.reefapi.com/metacritic/v1/title_news — 1 credit
News, features and galleries Metacritic tagged with a game, movie or show, newest first.

**Parameters:**
- `slug` (string, optional) — The title: a metacritic.com link (https://www.metacritic.com/game/elden-ring/), 'game/elden-ring', 'movie/oppenheimer', 'tv/severance', 'music/<album>/<artist>', or the bare slug with `type`. Movies and shows also take the numeric id from search; games by id are followed to their slug.
- `type` (enum, optional) — game, movie or show (TV). Not needed when `slug` is a metacritic.com link. [one of: game, movie, show]
- `page` (integer, optional, default 1) — Page number (1-based).
- `limit` (integer, optional, default 20) — Articles per page (1-20, default 20).

**Returns:** type, slug, url, page, limit, count, has_more, news[]{id, slug, title, kind, url, description, author, published, topics[], image_url}

**Example request body:**
```json
{
  "slug": "game/elden-ring"
}
```

### POST https://api.reefapi.com/metacritic/v1/browse — 1 credit
Metacritic's browse finder — the full catalogue of games, movies, TV shows or albums with every filter the site offers: genre, platform (games), streaming service (movies / TV), age rating, release year range, coming soon, in theaters (movies), Metascore and user score bounds, season view (TV) and seven sorts. Up to 100 per page with the site's own total (games by Metascore: 14,464; movies 17,454; TV 3,482; albums 23,637).

**Parameters:**
- `type` (enum, required) — game, movie, show or album. [one of: game, movie, show, album]
- `sort` (enum, optional, default "metascore") — metascore (best first), metascore_asc, userscore, userscore_asc, newest, oldest or popularity. Sorting by a score lists only titles that have that score, so `total` changes with the sort. [one of: metascore, metascore_asc, userscore, userscore_asc, newest, oldest, popularity]
- `genre` (array, optional) — One or more genres exactly as the site lists them (games: Action RPG, Platformer, First-Person Shooter…; movies / TV: Drama, Sci-Fi, Horror…; albums: Rock, Rap, Electronic…). Comma-separated or a list; several = any of them. `browse_filters` lists every value.
- `platform` (array, optional) — Games only: one or more platforms (PS5, PC, Xbox Series X/S, Nintendo Switch 2, Switch, PS4, Xbox One, 3DS, PS Vita, Wii U… 24 in all, name, slug or id); several = released on any of them.
- `network` (array, optional) — Movies and TV only: streaming services (Netflix, Prime Video, Disney+, HBO Max, Hulu, Apple TV, Paramount+, Peacock… 20 in all); several = any of them.
- `age_rating` (array, optional) — Age ratings: games E, E10+, T, M, AO; movies G, PG, PG-13, R, NC-17; TV TV-Y, TV-Y7, TV-G, TV-PG, TV-14, TV-MA. Several = any of them.
- `year` (integer, optional) — One release year (sets year_min = year_max).
- `year_min` (integer, optional) — Released in or after this year.
- `year_max` (integer, optional) — Released in or before this year.
- `release_type` (enum, optional) — coming-soon (not yet released; games, movies, TV) or in-theaters (movies now in US theaters). [one of: coming-soon, in-theaters]
- `metascore_min` (integer, optional) — Lowest Metascore (0-100).
- `metascore_max` (integer, optional) — Highest Metascore (0-100).
- `userscore_min` (number, optional) — Lowest user score (0-10).
- `userscore_max` (number, optional) — Highest user score (0-10).
- `season_view` (boolean, optional) — TV only: list individual seasons instead of shows (TV by Metascore: 3,482 shows → 4,156 seasons).
- `page` (integer, optional, default 1) — Page number (1-based).
- `limit` (integer, optional, default 24) — Titles per page (1-100, default 24).

**Returns:** type, sort, filters{…}, total, page, limit, total_pages, has_more, page_beyond_last, count, titles[]{id, type, title, slug, url, rank, release_date, release_year, metascore{score, review_count, positive/mixed/negative_count, sentiment}, user_score, age_rating, genres[], platforms[], description, duration_minutes, season_count, network, artists[] (albums), in_theaters, image_url}

**Example request body:**
```json
{
  "type": "movie"
}
```

### POST https://api.reefapi.com/metacritic/v1/browse_filters — 1 credit
Every filter value `browse` accepts for one type, read live from the site's filter catalogue: genres, platforms (games), streaming services (movies / TV), age ratings, plus the sorts.

**Parameters:**
- `type` (enum, required) — game, movie, show or album. [one of: game, movie, show, album]

**Returns:** type, genres[], platforms[]{id, name, slug}, networks[]{id, name, slug}, age_ratings[], sorts[], release_types[]

**Example request body:**
```json
{
  "type": "movie"
}
```

### POST https://api.reefapi.com/metacritic/v1/top_rated — 1 credit
Best-of list: the highest Metascores of all time or of one year (the site's 'Best games / movies / TV / albums of <year>' pages), optionally by genre, platform, streaming service or age rating.

**Parameters:**
- `type` (enum, required) — game, movie, show or album. [one of: game, movie, show, album]
- `year` (integer, optional) — One release year (sets year_min = year_max).
- `genre` (array, optional) — One or more genres exactly as the site lists them (games: Action RPG, Platformer, First-Person Shooter…; movies / TV: Drama, Sci-Fi, Horror…; albums: Rock, Rap, Electronic…). Comma-separated or a list; several = any of them. `browse_filters` lists every value.
- `platform` (array, optional) — Games only: one or more platforms (PS5, PC, Xbox Series X/S, Nintendo Switch 2, Switch, PS4, Xbox One, 3DS, PS Vita, Wii U… 24 in all, name, slug or id); several = released on any of them.
- `network` (array, optional) — Movies and TV only: streaming services (Netflix, Prime Video, Disney+, HBO Max, Hulu, Apple TV, Paramount+, Peacock… 20 in all); several = any of them.
- `age_rating` (array, optional) — Age ratings: games E, E10+, T, M, AO; movies G, PG, PG-13, R, NC-17; TV TV-Y, TV-Y7, TV-G, TV-PG, TV-14, TV-MA. Several = any of them.
- `page` (integer, optional, default 1) — Page number (1-based).
- `limit` (integer, optional, default 24) — Titles per page (1-100, default 24).

**Returns:** as browse

**Example request body:**
```json
{
  "type": "movie"
}
```

### POST https://api.reefapi.com/metacritic/v1/new_releases — 1 credit
Newest released titles first (the site's 'Newly Released' list). By default only titles that have a Metascore, like the site; `reviewed_only=false` adds the unreviewed long tail.

**Parameters:**
- `type` (enum, required) — game, movie, show or album. [one of: game, movie, show, album]
- `reviewed_only` (boolean, optional, default true) — Only titles with a Metascore (default true).
- `genre` (array, optional) — One or more genres exactly as the site lists them (games: Action RPG, Platformer, First-Person Shooter…; movies / TV: Drama, Sci-Fi, Horror…; albums: Rock, Rap, Electronic…). Comma-separated or a list; several = any of them. `browse_filters` lists every value.
- `platform` (array, optional) — Games only: one or more platforms (PS5, PC, Xbox Series X/S, Nintendo Switch 2, Switch, PS4, Xbox One, 3DS, PS Vita, Wii U… 24 in all, name, slug or id); several = released on any of them.
- `network` (array, optional) — Movies and TV only: streaming services (Netflix, Prime Video, Disney+, HBO Max, Hulu, Apple TV, Paramount+, Peacock… 20 in all); several = any of them.
- `age_rating` (array, optional) — Age ratings: games E, E10+, T, M, AO; movies G, PG, PG-13, R, NC-17; TV TV-Y, TV-Y7, TV-G, TV-PG, TV-14, TV-MA. Several = any of them.
- `page` (integer, optional, default 1) — Page number (1-based).
- `limit` (integer, optional, default 24) — Titles per page (1-100, default 24).

**Returns:** as browse

**Example request body:**
```json
{
  "type": "movie"
}
```

### POST https://api.reefapi.com/metacritic/v1/upcoming — 1 credit
Titles not released yet, soonest first (the site's 'Coming Soon'): games, movies or TV. The site has no coming-soon list for albums.

**Parameters:**
- `type` (enum, required) — game, movie or show. [one of: game, movie, show]
- `genre` (array, optional) — One or more genres exactly as the site lists them (games: Action RPG, Platformer, First-Person Shooter…; movies / TV: Drama, Sci-Fi, Horror…; albums: Rock, Rap, Electronic…). Comma-separated or a list; several = any of them. `browse_filters` lists every value.
- `platform` (array, optional) — Games only: one or more platforms (PS5, PC, Xbox Series X/S, Nintendo Switch 2, Switch, PS4, Xbox One, 3DS, PS Vita, Wii U… 24 in all, name, slug or id); several = released on any of them.
- `network` (array, optional) — Movies and TV only: streaming services (Netflix, Prime Video, Disney+, HBO Max, Hulu, Apple TV, Paramount+, Peacock… 20 in all); several = any of them.
- `page` (integer, optional, default 1) — Page number (1-based).
- `limit` (integer, optional, default 24) — Titles per page (1-100, default 24).

**Returns:** as browse

**Example request body:**
```json
{
  "type": "movie"
}
```

### POST https://api.reefapi.com/metacritic/v1/in_theaters — 1 credit
Movies now playing in US theaters, newest first or by Metascore.

**Parameters:**
- `sort` (enum, optional, default "newest") — newest (the site's default for this list), metascore or userscore. [one of: newest, metascore, userscore]
- `genre` (array, optional) — One or more genres exactly as the site lists them (games: Action RPG, Platformer, First-Person Shooter…; movies / TV: Drama, Sci-Fi, Horror…; albums: Rock, Rap, Electronic…). Comma-separated or a list; several = any of them. `browse_filters` lists every value.
- `page` (integer, optional, default 1) — Page number (1-based).
- `limit` (integer, optional, default 24) — Movies per page (1-100, default 24).

**Returns:** as browse

**Example request body:**
```json
{
  "genre": "Action RPG"
}
```

### POST https://api.reefapi.com/metacritic/v1/trending — 1 credit
This week's trending movies or TV shows on Metacritic, each with Metascore, rating, companies and where to watch (US).

**Parameters:**
- `type` (enum, required) — movie or show. [one of: movie, show]

**Returns:** type, count, titles[]{…card, companies[], where_to_watch{…}}

**Example request body:**
```json
{
  "type": "movie"
}
```

### POST https://api.reefapi.com/metacritic/v1/featured — 2 credits
The editorial lists on the home and section pages (their names follow the editorial calendar: 'Top Picks', 'New and Notable', 'Upcoming Games', 'Returning Shows'…), each with its titles; the home page also has the editorial spotlight articles.

**Parameters:**
- `section` (enum, optional, default "all") — all (home page), game, movie or show. [one of: all, game, movie, show]

**Returns:** section, count, lists[]{id, name, description, view_more_url, count, titles[] | articles[]}

### POST https://api.reefapi.com/metacritic/v1/seasons — 1 credit
Every season of a TV show with its Metascore block, premiere date, year and episode count.

**Parameters:**
- `show` (string, required) — The show's slug or metacritic.com/tv/<slug>/ link (a season / episode link also carries `season` / `episode`).

**Returns:** show{title, slug, url}, count, seasons[]{season, season_slug, url, release_year, premiere_date, episode_count, metascore{…}}

**Example request body:**
```json
{
  "show": "severance"
}
```

### POST https://api.reefapi.com/metacritic/v1/season_details — 2 credits
One TV season: Metascore block and user score block of that season, premiere date, episode count and the episode list with dates.

**Parameters:**
- `show` (string, required) — The show's slug or metacritic.com/tv/<slug>/ link (a season / episode link also carries `season` / `episode`).
- `season` (integer, optional) — TV only: the season number. A /tv/<show>/season-N/ link carries it.

**Returns:** show{…}, season, url, release_year, premiere_date, episode_count, metascore{…}, user_score{…}, episodes[]{episode, title, episode_slug, url, release_date, description, age_rating, duration_minutes}

**Example request body:**
```json
{
  "show": "severance"
}
```

### POST https://api.reefapi.com/metacritic/v1/episodes — 1 credit
The episode list of one season: number, title, date, summary, rating, runtime, genres, image.

**Parameters:**
- `show` (string, required) — The show's slug or metacritic.com/tv/<slug>/ link (a season / episode link also carries `season` / `episode`).
- `season` (integer, optional) — TV only: the season number. A /tv/<show>/season-N/ link carries it.

**Returns:** show{…}, season, count, episodes[]{…}

**Example request body:**
```json
{
  "show": "severance"
}
```

### POST https://api.reefapi.com/metacritic/v1/episode_details — 2 credits
One episode: title, number, air date, summary, TV rating, runtime, genres, cast and crew, and its user score block.

**Parameters:**
- `show` (string, required) — The show's slug or metacritic.com/tv/<slug>/ link (a season / episode link also carries `season` / `episode`).
- `season` (integer, optional) — TV only: the season number. A /tv/<show>/season-N/ link carries it.
- `episode` (string, optional) — Episode number in the season, or its slug (episode-1-hello-ms-cobel).

**Returns:** show{…}, season, episode, title, episode_slug, url, release_date, description, age_rating, duration_minutes, genres, cast[], crew[], user_score{…}

**Example request body:**
```json
{
  "show": "severance"
}
```

### POST https://api.reefapi.com/metacritic/v1/person — 2 credits
A cast / crew member or artist: name, portrait, and how many movie, TV, game and album credits Metacritic lists for them.

**Parameters:**
- `person` (string, required) — The person's slug or metacritic.com/person/<slug>/ link (from cast / crew rows or search with type person).

**Returns:** id, name, slug, url, image_url, professions, birth_date, birth_place, death_date, awards, credit_counts{movie, show, game, album}

**Example request body:**
```json
{
  "person": "christopher-nolan"
}
```

### POST https://api.reefapi.com/metacritic/v1/person_credits — 1 credit
A person's credits of one kind (movies, TV, games or albums): title, year, roles, Metascore, rating, image — sorted by date, name or score, 50 per page with a cursor for the next page.

**Parameters:**
- `person` (string, required) — The person's slug or metacritic.com/person/<slug>/ link (from cast / crew rows or search with type person).
- `type` (enum, optional, default "movie") — movie, show, game or album. [one of: movie, show, game, album]
- `sort` (enum, optional, default "date") — date (newest first), name or score. [one of: date, name, score]
- `limit` (integer, optional, default 50) — Credits per page (1-50, default 50).
- `cursor` (string, optional) — The next_cursor of the previous page.

**Returns:** person, type, sort, total, count, next_cursor, has_more, credits[]{title, type, slug, url, release_year, roles[], metascore{score}, age_rating, platforms[], duration_minutes, image_url}

**Example request body:**
```json
{
  "person": "christopher-nolan"
}
```

### POST https://api.reefapi.com/metacritic/v1/publication — 1 credit
A critic outlet's profile: how many game, movie and TV reviews it has on Metacritic, its positive / mixed / negative split and average score per category. The site's profile counts no music reviews (Pitchfork: 0 / 0 / 0 here while its review list holds 12,948 album reviews).

**Parameters:**
- `publication` (string, required) — The publication slug or metacritic.com/publication/<slug>/ link (critic review rows carry publication_slug).

**Returns:** slug, url, name, review_count, categories[]{category, review_count, positive_count, mixed_count, negative_count, *_percent, average_score}

**Example request body:**
```json
{
  "publication": "ign"
}
```

### POST https://api.reefapi.com/metacritic/v1/publication_reviews — 1 credit
Every review an outlet has on Metacritic, 10 per page (fixed by the site): quote, score, author, date, link, and the title reviewed with its Metascore. Filter by category and sentiment; sort by date, score or title.

**Parameters:**
- `publication` (string, required) — The publication slug or metacritic.com/publication/<slug>/ link (critic review rows carry publication_slug).
- `type` (enum, optional) — game, movie or show: only that category's reviews. Without it the list holds every review, music included (the site has no music filter here). [one of: game, movie, show]
- `sort` (enum, optional, default "date") — date (newest first), score (highest first) or name (title A-Z). [one of: date, score, name]
- `sentiment` (enum, optional, default "all") — all, positive, mixed or negative (the site's own filter tabs). [one of: all, positive, mixed, negative]
- `page` (integer, optional, default 1) — Page number (1-based).

**Returns:** slug, url, name, type, sort, sentiment, total, page, total_pages, has_more, count, reviews[]{…critic review, reviewed{id, type, title, url, metascore, platform}}

**Example request body:**
```json
{
  "publication": "ign"
}
```

### POST https://api.reefapi.com/metacritic/v1/critic_profile — 1 credit
An individual critic's profile: review counts per category with positive / mixed / negative and average score.

**Parameters:**
- `critic` (string, required) — The critic's slug or metacritic.com/critic/<slug>/ link (critic review rows carry author_slug).

**Returns:** slug, url, name, review_count, categories[]{…}

**Example request body:**
```json
{
  "critic": "leanne-butkovic"
}
```

### POST https://api.reefapi.com/metacritic/v1/critic_profile_reviews — 1 credit
An individual critic's reviews, 10 per page: quote, score, publication, date, link and the title reviewed. Filter by category and sentiment; sort by date, score or publication.

**Parameters:**
- `critic` (string, required) — The critic's slug or metacritic.com/critic/<slug>/ link (critic review rows carry author_slug).
- `type` (enum, optional) — game, movie or show: only that category's reviews. Without it the list holds every review, music included (the site has no music filter here). [one of: game, movie, show]
- `sort` (enum, optional, default "date") — date, score or publication. [one of: date, score, publication]
- `sentiment` (enum, optional, default "all") — all, positive, mixed or negative (the site's own filter tabs). [one of: all, positive, mixed, negative]
- `page` (integer, optional, default 1) — Page number (1-based).

**Returns:** slug, url, name, type, sort, sentiment, total, page, total_pages, has_more, count, reviews[]

**Example request body:**
```json
{
  "critic": "leanne-butkovic"
}
```

### POST https://api.reefapi.com/metacritic/v1/user_profile — 1 credit
A Metacritic member's public profile: review counts per category, positive / mixed / negative, average score, and their highest and lowest rated title.

**Parameters:**
- `user` (string, required) — The member's username or metacritic.com/user/<name>/ link (user review rows carry author).

**Returns:** username, url, review_count, categories[]{category, review_count, …, average_score, highest_rated{score, title, url}, lowest_rated{…}}

**Example request body:**
```json
{
  "user": "Ultragaming"
}
```

### POST https://api.reefapi.com/metacritic/v1/user_profile_reviews — 1 credit
A member's public reviews in one category: quote, score, date, spoiler flag and the title reviewed. Sort by date or score; up to 100 per page.

**Parameters:**
- `user` (string, required) — The member's username or metacritic.com/user/<name>/ link (user review rows carry author).
- `type` (enum, optional, default "game") — game, movie or show (the site lists one category at a time and has no music tab for members). [one of: game, movie, show]
- `sort` (enum, optional, default "date") — date (newest first) or score. [one of: date, score]
- `page` (integer, optional, default 1) — Page number (1-based).
- `limit` (integer, optional, default 20) — Reviews per page (1-100, default 20).

**Returns:** username, url, type, sort, total, page, limit, total_pages, has_more, count, reviews[]

**Example request body:**
```json
{
  "user": "Ultragaming"
}
```

### POST https://api.reefapi.com/metacritic/v1/news — 1 credit
Metacritic's latest news, features, rankings and galleries — all sections, or games, movies or TV.

**Parameters:**
- `section` (enum, optional, default "all") — all, game, movie or show. [one of: all, game, movie, show]
- `page` (integer, optional, default 1) — Page number (1-based).
- `limit` (integer, optional, default 20) — Articles per page (1-20, default 20).

**Returns:** section, name, page, limit, count, has_more, news[]{id, slug, title, kind, section, url, description, author, author_title, published, word_count, topics[], image_url}

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

### POST https://api.reefapi.com/metacritic/v1/news_article — 2 credits
One Metacritic article or gallery. Articles: headline, standfirst, authors, published / updated dates, section, topics, the article text and the titles it embeds with their Metascores. Galleries (the site's ranked and 'best of' lists, /pictures/<slug>/): every slide with its rank, title, text, image and the catalogue titles it links, with their Metascores.

**Parameters:**
- `article` (string, required) — The article or gallery slug, or its metacritic.com/news/<slug>/ or /pictures/<slug>/ link (news rows carry slug and url).

**Returns:** id, slug, url, headline, dek, kind, section, authors[], published, display_published, updated, topics[], tags[], image_url, body_text, mentioned_titles[]{id, type, title, url, metascore} — galleries: slide_count, slides[]{position, rank, rank_text, title, text, image_url, image_credits, titles[]{…title row, metascore}}

**Example request body:**
```json
{
  "article": "upcoming-movie-release-dates-schedule"
}
```

### POST https://api.reefapi.com/metacritic/v1/videos — 1 credit
The latest trailers and clips playlist of the home page, games or movies: title, duration, publish date, poster, HLS stream and MP4 renditions.

**Parameters:**
- `section` (enum, optional, default "all") — all (home page), game or movie. [one of: all, game, movie]

**Returns:** section, name, count, videos[]{media_id, title, description, duration_seconds, published, poster_url, hls_url, mp4[]{url, width, height}, page_url}

## 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=metacritic
- Human docs page: https://reefapi.com/docs/metacritic
- Overview page: https://reefapi.com/metacritic-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
