Metacritic API endpoint
Returns a Metacritic TV show: Metascore (critic) and user score with sentiment and review counts, genres, networks, season count, rating, release date, IMDb id, and trailer.
/metacritic/tv/{slug}Path parameters:
slug (required) — Metacritic tv slug, e.g. breaking-bad (the last path segment of the metacritic.com/tv/… 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 | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| name | 20 | “Vince Gilligan” and 15 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | Metacritic TV show slug | shogun | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/metacritic/tv/shogun" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": 789,
"type": "tv",
"title": "Breaking Bad",
"slug": "breaking-bad",
"url": "https://www.metacritic.com/tv/breaking-bad/",
"premiere_year": 2008,
"rating": "TV-MA",
"season_count": 5,
"metascore": {
"score": 87,
"max": 100,
"sentiment": "Universal acclaim"
},
"user_score": {
"score": 9.5,
"max": 10,
"sentiment": "Universal acclaim"
},
"genres": [
{
"name": "Drama"
}
],
"networks": [
"AMC"
],
"imdb_id": "tt0903747"
}
}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/tv/shogun" \
-H "x-api-key: $CRAWLORA_API_KEY"