{ "openapi": "3.0.1", "info": { "title": "Metacritic Scraper — Metascores, user scores & reviews", "description": "Scrape Metacritic games, movies and TV shows: Metascore, user score, review counts and sentiment, release date, platforms, genres, developer, publisher and age rating, plus critic and user reviews. Browse with filters or pass title URLs. No API key needed.", "version": "0.1", "x-build-id": "qcglcnm9FGzUJBgZQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/istmobot~metacritic-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-istmobot-metacritic-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/istmobot~metacritic-scraper/runs": { "post": { "operationId": "runs-sync-istmobot-metacritic-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/istmobot~metacritic-scraper/run-sync": { "post": { "operationId": "run-sync-istmobot-metacritic-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "browse", "titles" ], "type": "string", "description": "\"browse\": list titles from Metacritic's catalog using the filters below (like metacritic.com/browse). \"titles\": scrape specific titles from URLs or slugs.", "default": "browse" }, "productType": { "title": "Product type", "enum": [ "games", "movies", "tv" ], "type": "string", "description": "What to browse. In \"titles\" mode this is only used for bare slugs (URLs carry their own type).", "default": "games" }, "sortBy": { "title": "Sort by", "enum": [ "-metaScore", "-userScore", "-releaseDate", "releaseDate" ], "type": "string", "description": "Browse order. Sorting by Metascore only returns titles that have a Metascore.", "default": "-metaScore" }, "yearFrom": { "title": "Release year from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only titles released in or after this year." }, "yearTo": { "title": "Release year to", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only titles released in or before this year." }, "genres": { "title": "Genres", "type": "array", "description": "Metacritic genre names exactly as shown on the site, e.g. games: \"Action RPG\", \"JRPG\", \"Open-World Action\", \"3D Platformer\"; movies/TV: \"Horror\", \"Drama\", \"Comedy\", \"Documentary\". A title matches if it has any of them.", "items": { "type": "string" } }, "platforms": { "title": "Platforms (games only)", "type": "array", "description": "e.g. \"PC\", \"PS5\", \"PS4\", \"Xbox Series X\", \"Xbox One\", \"Nintendo Switch\", \"Nintendo Switch 2\", \"Mobile\", \"Meta Quest\" — plus retro: PS1/PS2/PS3, Xbox 360, Wii, Wii U, 3DS, DS, GameCube, N64, Dreamcast.", "items": { "type": "string" } }, "startUrls": { "title": "Metacritic URLs", "type": "array", "description": "Title pages for \"titles\" mode, e.g. https://www.metacritic.com/game/elden-ring/ or https://www.metacritic.com/movie/the-godfather/. Add ?platform=pc to a game URL to get that platform's scores and reviews.", "items": { "type": "string" } }, "slugs": { "title": "Slugs", "type": "array", "description": "Alternative to URLs: the slug from the URL (e.g. \"baldurs-gate-3\"). Interpreted with the product type above.", "items": { "type": "string" } }, "includeCriticReviews": { "title": "Include critic reviews", "type": "boolean", "description": "Add critic reviews (publication, score, quote, link) to each title.", "default": false }, "includeUserReviews": { "title": "Include user reviews", "type": "boolean", "description": "Add user reviews (username, score, text, date) to each title.", "default": false }, "maxReviewsPerTitle": { "title": "Max reviews per title (per type)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Cap for critic reviews and for user reviews, each. Popular titles have thousands of user reviews.", "default": 20 }, "maxItems": { "title": "Max titles", "minimum": 1, "type": "integer", "description": "Stop after this many titles.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }