Metacritic API endpoint
Returns paginated user reviews for a game: author, score (0-10), quote, date, platform, helpfulness, and spoiler flag.
/metacritic/game/{slug}/user-reviewsPath 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, helpful.Response includes type, slug, total, page, per_page, sort, and reviews[] (id, author, score, quote, date, platform, thumbs_up, thumbs_down, spoiler).
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| author | 20 | |
| score | 20 | 4 to 10, median 9 |
| quote | 20 | median 244 characters |
| date | 20 | 2025-09-26 to 2026-10-11 |
| platform | 20 |
| 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, helpful. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/metacritic/game/elden-ring/user-reviews?page=1&sort=date" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"type": "game",
"slug": "elden-ring",
"total": 573,
"page": 1,
"per_page": 20,
"sort": "date",
"reviews": [
{
"id": "6b0405c7",
"author": "exogan",
"score": 9,
"quote": "Instant classic.",
"date": "2026-03-22"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/metacritic.userReviewsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | metacritic.UserReviewsResponse | 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 | User reviews on this page. | |||
| data.reviews[].author | string | No | Username of the member who wrote the review. | |||
| data.reviews[].date | string | No | Date the review was posted, in YYYY-MM-DD. | |||
| data.reviews[].id | string | No | Metacritic review id. | |||
| data.reviews[].platform | string | No | Platform the game was reviewed on. Set for game reviews. | |||
| data.reviews[].quote | string | No | Text of the user review. | |||
| data.reviews[].score | integer | No | Score the user gave, out of 10. Omitted when the review has no score. | |||
| data.reviews[].spoiler | boolean | No | Whether the review is flagged as containing spoilers. | |||
| data.reviews[].thumbs_down | integer | No | Number of members who voted the review not helpful. | |||
| data.reviews[].thumbs_up | integer | No | Number of members who voted the review helpful. | |||
| data.slug | string | No | Metacritic slug of the title the reviews belong to. | |||
| data.sort | string | No | Sort order applied: `date`, `score` or `helpful`. | |||
| data.total | integer | No | Total number of user 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/user-reviews?page=1&sort=date" \
-H "x-api-key: $CRAWLORA_API_KEY"