{ "openapi": "3.0.1", "info": { "title": "Metacritic Scraper: Metascores, Games, Movies & TV", "description": "Scrape Metacritic metascores for 14,000+ games, 17,000+ movies and 3,400+ TV shows. Get ranked lists, search, user scores, sentiment breakdowns and critic review quotes. Filter by year and sort. Export CSV, Excel, JSON, XML. No login or API key, public data only.", "version": "0.1", "x-build-id": "FDK25MOq5sOVha5v0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/recordsdata~metacritic-scores-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-recordsdata-metacritic-scores-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/recordsdata~metacritic-scores-scraper/runs": { "post": { "operationId": "runs-sync-recordsdata-metacritic-scores-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/recordsdata~metacritic-scores-scraper/run-sync": { "post": { "operationId": "run-sync-recordsdata-metacritic-scores-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": { "includeBrowse": { "title": "Browse ranked list", "type": "boolean", "description": "Scrape the ranked Metacritic list (metascore, review count, platforms, genres, user score, image) for the selected media type. Ignored when a search query is set.", "default": true }, "productType": { "title": "Media type", "enum": [ "games", "movies", "tv", "music" ], "type": "string", "description": "Choose which Metacritic catalog to list: games, movies, TV shows or music (albums). Music supports year, score and sort filters; genre and platform filters apply to the other catalogs.", "default": "games" }, "sortBy": { "title": "Sort by", "enum": [ "-metaScore", "metaScore", "-releaseDate", "-userScore", "userScore" ], "type": "string", "description": "Order of the ranked list. Metascore and user score can be read best first or worst first; titles without a score are left out of the worst-first lists.", "default": "-metaScore" }, "yearMin": { "title": "Year from (optional)", "minimum": 1900, "type": "integer", "description": "Only include titles released in this year or later, for example 2020." }, "yearMax": { "title": "Year to (optional)", "minimum": 1900, "type": "integer", "description": "Only include titles released in this year or earlier, for example 2025." }, "platforms": { "title": "Game platforms (optional)", "type": "array", "description": "Games only. Keep titles released on any of these platforms; in the ranked list the metascore of each row is the one for the platform you pick (the PC score and the PS5 score of the same game differ), in search results it only filters. Leave empty for all platforms.", "items": { "type": "string", "enum": [ "pc", "ps5", "ps4", "ps3", "ps2", "ps1", "psp", "vita", "xbox-series-x", "xbox-one", "xbox-360", "xbox", "switch", "switch-2", "wii-u", "wii", "3ds", "ds", "gamecube", "n64", "gba", "dreamcast", "meta-quest" ], "enumTitles": [ "PC", "PlayStation 5", "PlayStation 4", "PlayStation 3", "PlayStation 2", "PlayStation", "PSP", "PlayStation Vita", "Xbox Series X", "Xbox One", "Xbox 360", "Xbox", "Nintendo Switch", "Nintendo Switch 2", "Wii U", "Wii", "3DS", "DS", "GameCube", "Nintendo 64", "Game Boy Advance", "Dreamcast", "Meta Quest" ] }, "default": [] }, "genres": { "title": "Genres (optional)", "type": "array", "description": "Keep titles with any of these genres, using the Metacritic name, for example \"Action RPG\", \"Open-World\", \"Drama\", \"Comedy\", \"Sci-Fi\". Names are not case sensitive. Leave empty for all genres.", "default": [], "items": { "type": "string" } }, "minMetascore": { "title": "Minimum metascore (optional)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only titles with a metascore of at least this value (0 to 100), for example 85 for universal acclaim. Titles without a metascore are left out." }, "maxMetascore": { "title": "Maximum metascore (optional)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only titles with a metascore of at most this value (0 to 100), for example 50 to find the worst-rated titles." }, "minUserScore": { "title": "Minimum user score (optional)", "minimum": 0, "maximum": 10, "type": "number", "description": "Only titles with a user score of at least this value (0 to 10, decimals allowed), for example 8.5. Applies to the ranked list; search results do not carry a user score." }, "searchQuery": { "title": "Search (optional)", "type": "string", "description": "Search Metacritic by title keyword, for example zelda or batman. Returns games, movies and TV shows mixed, with metascores. People and companies in the results are skipped.", "default": "" }, "searchOnlySelectedType": { "title": "Search only the selected media type", "type": "boolean", "description": "Keep only results of the media type chosen above (for example only games) instead of games, movies and TV shows mixed.", "default": false }, "titleSlugs": { "title": "Title slugs (full details)", "type": "array", "description": "Slugs or URLs for full records with user score, critic and user review breakdown, platform scores, cast and crew, awards and where to watch (e.g. elden-ring, or https://www.metacritic.com/movie/dune-part-two/). A bare slug is looked up under the media type above first, then under the other two.", "default": [], "items": { "type": "string" } }, "includeCriticReviews": { "title": "Critic reviews per title", "type": "boolean", "description": "Also extract one row per critic review (publication, author, score, quote, date, link) for each title slug above.", "default": false }, "maxReviewsPerTitle": { "title": "Max critic reviews per title", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum critic review rows extracted per title slug, from 1 to 5,000.", "default": 40 }, "includeUserReviews": { "title": "User reviews per title", "type": "boolean", "description": "Also extract one row per user review (author, score, text, date, thumbs up and down, spoiler flag) for each title slug above. Billed as its own event, see the Pricing tab.", "default": false }, "maxUserReviewsPerTitle": { "title": "Max user reviews per title", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum user review rows extracted per title slug, from 1 to 5,000.", "default": 40 }, "reviewSentiment": { "title": "Review sentiment", "enum": [ "all", "positive", "mixed", "negative" ], "type": "string", "description": "Which critic and user reviews to extract: all of them, or only the positive, mixed or negative ones.", "default": "all" }, "onlyNew": { "title": "Only new results", "type": "boolean", "description": "Return only titles and reviews that earlier runs of the same search have not delivered. Schedule the actor to track new releases and new reviews; already seen rows are skipped and not charged. The memory is kept in your own account.", "default": false }, "stateKey": { "title": "Monitor name (optional)", "type": "string", "description": "Name for the memory of previous results. Leave empty to derive it from your inputs. Use the same name to share memory between runs, or a different name to keep separate monitors.", "default": "" }, "resetSeen": { "title": "Forget previous results", "type": "boolean", "description": "Clear the memory for this monitor before the run, so every title and review counts as new again.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of rows to return across the whole run. Free users are limited to 10 items (preview). Paid users: optional, max 1,000,000.", "default": 10 } } }, "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 } } } } } } } } } }