Metacritic API endpoint
Returns a Metacritic game: Metascore (critic) and user score with sentiment and review counts, genres, per-platform scores, developer/publisher, rating, release date, and trailer.
/metacritic/game/{slug}Path parameters:
slug (required) — Metacritic game slug, e.g. elden-ring (the last path segment of the metacritic.com/game/… URL).Response includes id, type, title, slug, url, description, premiere_year, release_date, rating, metascore (score, max, review_count, positive_count, neutral_count, negative_count, sentiment, url), user_score (same shape, 0–10 scale; omitted when a title has no user reviews), genres[], and production. Games also carry platforms[] (with per-platform metascore) and countries[]; movies/TV carry networks[], imdb_id; TV carries season_count. A metascore/user_score is omitted entirely when a title is not yet scored.
| Field | In the sample | Value in the sample |
|---|---|---|
| id | Has a value | |
| type | Has a value | “game” |
| title | Has a value | “Elden Ring” |
| slug | Has a value | |
| url | Has a value | metacritic.com |
| description | Has a value | 1,059 characters |
| premiere_year | Has a value | 2,022 |
| release_date | Has a value | 2022-02-25 |
| rating | Has a value | “M” |
| metascore.score | Has a value | 96 |
| metascore.max | Has a value | 100 |
| metascore.review_count | Has a value | 93 |
| metascore.positive_count | Has a value | 86 |
| metascore.sentiment | Has a value | “Universal acclaim” |
| metascore.url | Has a value | metacritic.com |
| user_score.score | Has a value | 8.4 |
| user_score.max | Has a value | 10 |
| user_score.review_count | Has a value | 24,825 |
| user_score.positive_count | Has a value | 20,370 |
| user_score.neutral_count | Has a value | 1,594 |
| user_score.negative_count | Has a value | 2,861 |
| user_score.sentiment | Has a value | |
| user_score.url | Has a value | metacritic.com |
| genres | Has a value | 1 entry |
| production.companies | Has a value | 2 entries |
| platforms | Has a value | 5 entries |
| countries | Has a value | 6 entries |
| image | Has a value | “6-1-824956-52.jpg” |
| video.title | Has a value | “Every Scadutree Fragment Location Guide | Elden Ring: Shado…” |
| video.embed_url | Has a value | cdn.jwplayer.com |
| video.duration | Has a value | 1,589 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | Metacritic game slug | elden-ring | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/metacritic/game/elden-ring" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": 123,
"type": "game",
"title": "Elden Ring",
"slug": "elden-ring",
"url": "https://www.metacritic.com/game/elden-ring/",
"premiere_year": 2022,
"release_date": "2022-02-25",
"rating": "M",
"metascore": {
"score": 96,
"max": 100,
"review_count": 93,
"positive_count": 86,
"sentiment": "Universal acclaim",
"url": "https://www.metacritic.com/game/elden-ring/critic-reviews/"
},
"user_score": {
"score": 8.4,
"max": 10,
"review_count": 23997,
"sentiment": "Generally favorable"
},
"genres": [
{
"name": "Action RPG"
}
],
"production": {
"companies": [
"FromSoftware",
"Bandai Namco Games"
]
},
"platforms": [
{
"name": "PlayStation 5",
"is_lead": true,
"metascore": {
"score": 96,
"max": 100
}
}
]
}
}Request schema
No body schema
Response schema
#/definitions/metacritic.productResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | metacritic.Product | No | ||||
| data.countries | array | No | Countries Metacritic lists for the title. | |||
| data.description | string | No | Plot or game summary as shown on Metacritic. | |||
| data.duration | integer | No | Running time of the title as Metacritic lists it. | |||
| data.genres | array | No | Genres Metacritic assigns to the title. | |||
| data.genres[].id | integer | No | Metacritic genre id. | |||
| data.genres[].name | string | No | Genre name, for example `Action RPG`. | |||
| data.id | integer | No | Metacritic's numeric id for the title. | |||
| data.image | string | No | Main image of the title as Metacritic lists it. | |||
| data.imdb_id | string | No | IMDb id of the title, for example `tt0903747`. | |||
| data.imdb_url | string | No | URL of the title's IMDb page. | |||
| data.in_theaters | boolean | No | Whether the movie is currently in theaters. Omitted when false. | |||
| data.metascore | object | No | Critic score summary for the title. | |||
| data.metascore.max | integer | No | 100 | Highest possible value of `score`, for example `100`. | ||
| data.metascore.negative_count | integer | No | Number of negative reviews counted in the score. | |||
| data.metascore.neutral_count | integer | No | Number of neutral (mixed) reviews counted in the score. | |||
| data.metascore.positive_count | integer | No | Number of positive reviews counted in the score. | |||
| data.metascore.review_count | integer | No | Number of reviews the score is based on. | |||
| data.metascore.score | number | No | Score value on the scale given by `max`. Metascores are out of 100 and user scores out of 10. | |||
| data.metascore.sentiment | string | No | Universal acclaim | Metacritic's verdict for the score, for example `Universal acclaim`. | ||
| data.metascore.url | string | No | Metacritic page listing the reviews behind the score. | |||
| data.networks | array | No | TV networks that air the show. | |||
| data.platforms | array | No | Platforms the game is released on, each with its own Metascore. Platform record, 13 fields: id, is_lead, metascore, name, release_date. Described under Metacritic Movie API. | |||
| data.premiere_year | integer | No | Year the title premiered or was first released. | |||
| data.production | object | No | Companies, crew and official site for the title. | |||
| data.production.companies | array | No | Companies involved in making or publishing the title, without duplicates (up to 12). | |||
| data.production.crew | array | No | Crew credits for the title. | |||
| data.production.crew[].name | string | No | Name of the person credited. | |||
| data.production.crew[].role | string | No | Director | Role of the person on the title, for example `Director`. | ||
| data.production.official_site | string | No | URL of the title's official website. | |||
| data.rating | string | No | M | Content rating of the title, for example `M` or `TV-MA`. | ||
| data.release_date | string | No | 2022-02-25 | Release date of the title, in YYYY-MM-DD. | ||
| data.season_count | integer | No | Number of seasons of the show. | |||
| data.slug | string | No | Metacritic URL slug of the title. Use it with the review endpoints. | |||
| data.tagline | string | No | Marketing tagline of the title. | |||
| data.title | string | No | Title name as shown on Metacritic. | |||
| data.type | string | No | game | Content type of the title: `game`, `movie` or `tv`. | ||
| data.url | string | No | Metacritic page URL of the title. | |||
| data.user_score | object | No | User score summary for the title. Omitted when it has no user score yet. | |||
| data.user_score.max | integer | No | 100 | Highest possible value of `score`, for example `100`. | ||
| data.user_score.negative_count | integer | No | Number of negative reviews counted in the score. | |||
| data.user_score.neutral_count | integer | No | Number of neutral (mixed) reviews counted in the score. | |||
| data.user_score.positive_count | integer | No | Number of positive reviews counted in the score. | |||
| data.user_score.review_count | integer | No | Number of reviews the score is based on. | |||
| data.user_score.score | number | No | Score value on the scale given by `max`. Metascores are out of 100 and user scores out of 10. | |||
| data.user_score.sentiment | string | No | Universal acclaim | Metacritic's verdict for the score, for example `Universal acclaim`. | ||
| data.user_score.url | string | No | Metacritic page listing the reviews behind the score. | |||
| data.video | object | No | Trailer or clip Metacritic links for the title. | |||
| data.video.duration | integer | No | Length of the video as Metacritic lists it. | |||
| data.video.embed_url | string | No | URL for embedding the video player. | |||
| data.video.title | string | No | Title of the video. | |||
| data.video.url | string | No | URL of the video. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/metacritic/game/elden-ring" \
-H "x-api-key: $CRAWLORA_API_KEY"