Metacritic API endpoint
Lists critic reviews for a Metacritic TV show by `slug` (such as `breaking-bad`). Each review has the publication, score, quote, author, date 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/tv/{slug}/critic-reviewsReturns paginated professional/publication reviews for a tv: the publication, its score, a quote, author, and the source URL.
Path 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, publication.Response includes type, slug, total, page, per_page, sort, and reviews[] (publication, publication_slug, score, quote, author, date, platform, url).
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| publication | 10 | |
| publication_slug | 10 | |
| score | 10 | 67 to 100, median 100 |
| quote | 10 | median 104 characters |
| author | 10 | |
| date | 10 | 2012-07-12 to 2012-08-22 |
| url | 8 | newyorker.com and 7 other hosts |
| 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, publication. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/metacritic/tv/shogun/critic-reviews?page=1&sort=date" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"type": "tv",
"slug": "breaking-bad",
"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. | |||
| data.reviews[].author | string | No | Name of the critic who wrote the review. | |||
| data.reviews[].date | string | No | 2022-02-23 | Date the review was published, in YYYY-MM-DD. | ||
| data.reviews[].platform | string | No | Platform the game was reviewed on. Set for game reviews. | |||
| data.reviews[].publication | string | No | Name of the publication that published the review. | |||
| data.reviews[].publication_slug | string | No | Metacritic slug of the publication. | |||
| data.reviews[].quote | string | No | Excerpt or summary of the review text. | |||
| data.reviews[].score | integer | No | Score the critic gave, out of 100. Omitted when the review has no score. | |||
| data.reviews[].url | string | No | URL of the full review on the publication's site. | |||
| 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/tv/shogun/critic-reviews?page=1&sort=date" \
-H "x-api-key: $CRAWLORA_API_KEY"