Metacritic API endpoint
Lists critic reviews for a Metacritic game by `slug` (such as `elden-ring`). Each review has the publication, score, quote, author, date, platform and source URL. `sort` is `date` (default), `score` or `publication`; `page` defaults to 1 and `per_page` to 20 with a max of 50. The response includes the `total` count.
/metacritic/game/{slug}/critic-reviewsReturns paginated professional/publication reviews for a game: the publication, its score, a quote, author, and the source URL.
Path parameters:
slug (required) — Metacritic game slug, e.g. elden-ring.Query parameters:
page (optional, default 1) — 1-based page number.per_page (optional, default 20, max 50).sort (optional, default date). Allowed values: date, score, publication.| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| publication | 10 | |
| publication_slug | 10 | |
| score | 10 | 100 |
| quote | 10 | median 161 characters |
| date | 10 | 2022-02-23 |
| platform | 10 | |
| url | 10 | areajugones.sport.es and 9 other hosts |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | Metacritic game slug | elden-ring | |
| page | integer | No | 1-based page number (default 1) | ||
| per_page | integer | No | Results per page (default 20, max 50) | ||
| sort | string | No | Sort order Allowed values: date, score, publication. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/metacritic/game/elden-ring/critic-reviews?page=1&sort=date" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"type": "game",
"slug": "elden-ring",
"total": 93,
"page": 1,
"per_page": 20,
"sort": "date",
"reviews": [
{
"publication": "Areajugones",
"publication_slug": "areajugones",
"score": 100,
"quote": "A masterpiece.",
"date": "2022-02-23",
"platform": "PlayStation 5",
"url": "https://areajugones.sport.es/..."
}
]
}
}Request schema
No body schema
Response schema
#/definitions/metacritic.criticReviewsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | metacritic.CriticReviewsResponse | No | ||||
| data.page | integer | No | Page number returned, starting at 1. | |||
| data.per_page | integer | No | Number of reviews per page. | |||
| data.reviews | array | No | Critic reviews on this page. CriticReview record, 8 fields: author, date, platform, publication, publication_slug, quote, score, url. Described under Metacritic TV Critic Reviews API. | |||
| data.slug | string | No | Metacritic slug of the title the reviews belong to. | |||
| data.sort | string | No | Sort order applied: `date`, `score` or `publication`. | |||
| data.total | integer | No | Total number of critic reviews for the title. | |||
| data.type | string | No | Content type of the title: `game`, `movie` or `tv`. | |||
| 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/critic-reviews?page=1&sort=date" \
-H "x-api-key: $CRAWLORA_API_KEY"