Metacritic API endpoint
Returns paginated user reviews for a TV show: author, score (0-10), quote, date, helpfulness, and spoiler flag.
/metacritic/tv/{slug}/user-reviewsPath parameters:
slug (required) — Metacritic tv slug, e.g. breaking-bad.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 | 0 to 10, median 10 |
| quote | 20 | median 129 characters |
| date | 20 | 2026-05-13 to 2026-10-09 |
| spoiler | 5 | true in 5 of 5 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | Metacritic TV show slug | shogun | |
| 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/tv/shogun/user-reviews?page=1&sort=date" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"type": "tv",
"slug": "breaking-bad",
"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/tv/shogun/user-reviews?page=1&sort=date" \
-H "x-api-key: $CRAWLORA_API_KEY"