metacritic.com APImetacritic.com ↗
Access Metacritic scores, critic and user reviews, and ranked lists for games, movies, and TV shows via 4 structured JSON endpoints.
curl -X GET 'https://api.parse.bot/scraper/fc50c015-8084-45b3-b1c7-d98ec7af4b14/search?query=the+last+of+us' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for movies, TV shows, and video games using Metacritic's autosuggest API. Returns metadata like title, release date, platforms, genres, and critic score.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search term to find items (e.g. 'elden ring', 'inception') |
{
"type": "object",
"fields": {
"items": "array of search result objects containing id, type, title, slug, releaseDate, genres, platforms, criticScoreSummary, and description"
},
"sample": {
"data": {
"items": [
{
"id": 1300589901,
"slug": "elden-ring-shadow-of-the-erdtree",
"type": "game-title",
"title": "Elden Ring: Shadow of the Erdtree",
"genres": [
{
"id": null,
"name": "Action RPG"
}
],
"typeId": 13,
"platforms": [
{
"id": null,
"name": "PlayStation 5"
},
{
"id": null,
"name": "PC"
}
],
"releaseDate": "2024-06-21",
"premiereYear": 2024,
"criticScoreSummary": {
"url": "/game/elden-ring-shadow-of-the-erdtree/critic-reviews/",
"score": 94
}
}
]
},
"status": "success"
}
}About the metacritic.com API
The Metacritic API exposes 4 endpoints covering search, detailed metadata, reviews, and ranked lists for games, movies, and TV shows. The get_reviews endpoint returns individual critic and user review quotes with scores and publication names, while get_top_items surfaces ranked lists filterable by year, sort order, and category — all as structured JSON with consistent field shapes across media types.
Search and Item Lookup
The search endpoint accepts a free-text query and returns an array of matching items, each with a criticScoreSummary, releaseDate, genres, platforms, and a slug you can pass directly into other endpoints. The get_details endpoint takes that slug plus a category (game, movie, or tv) and returns the canonical metascore, user_score, release_date, summary, and a raw_ld_json object with the full structured data embedded on the page. Platform arrays are populated for games; they return empty for movies and TV.
Reviews
The get_reviews endpoint retrieves up to 10 reviews per page for a given slug and category. Setting review_type to critic returns results with publication and author fields alongside a quote and numeric score. Setting it to user returns the same shape with usernames in place of publications. The count field in the response tells you how many reviews were returned in that page.
Ranked Lists
The get_top_items endpoint lists up to 24 items per page, ordered by metascore, userscore, or date. You can narrow results with the year parameter (e.g. '2024') and the category parameter. Each item in the response includes rank, title, slug, metascore, user_score, release_date, description, and a direct url to the Metacritic page. Pagination uses the page integer parameter.
- Build a game recommendation tool that surfaces the highest-rated titles for a given year using
get_top_itemssorted bymetascore. - Aggregate critic and user review quotes for a movie by slug using
get_reviewswithreview_typeset tocriticoruser. - Power a media search widget that returns Metacritic scores and genres instantly from the
searchendpoint. - Track score divergence between
metascoreanduser_scoreacross TV seasons fetched viaget_details. - Compile ranked lists of top-reviewed games by platform and year for a gaming news dashboard.
- Enrich a movie database with structured LD+JSON metadata and canonical URLs via the
raw_ld_jsonfield inget_details. - Monitor yearly trends in critic consensus by paginating through
get_top_itemsacross multipleyearvalues.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Metacritic have an official developer API?+
What does `get_reviews` return, and can I get more than 10 reviews at once?+
get_reviews returns up to 10 review objects, each with score, author, publication, date, and quote. The response includes a count field showing how many reviews came back. The endpoint does not currently expose a pagination parameter for fetching beyond the first page of reviews. You can fork this API on Parse and revise it to add offset or page-based pagination for reviews.Does `get_details` return platform data for movies and TV shows?+
platforms field is populated for games. For movies and TV items, it returns an empty array. Genre, score, and summary fields are present for all three category types.Can I retrieve season-level or episode-level data for TV shows?+
get_details endpoint returns top-level metadata for a TV show identified by its slug — title, overall metascore, user score, genres, and summary. Individual season or episode breakdowns are not exposed. You can fork this API on Parse and revise it to add a season-level endpoint.