{ "openapi": "3.0.1", "info": { "title": "๐Ÿš€ Metacritic Scraper ยท 5,000 Free Titles/Month", "description": "Metacritic Scraper gets you games, movies & TV โšก fast, ๐ŸŽฏ 100% accurate and ๐Ÿ” ridiculously detailed โ€” search, top rated, new & upcoming lists with Metascore, user score & posters, full pages on demand. ๐Ÿ’ฐ $1 per 1,000 titles, no start fee. Scrape your first 5,000 titles free every month ๐Ÿš€", "version": "0.0", "x-build-id": "wNJm7fhcVTXvgJBtm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/omkar-cloud~metacritic-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-omkar-cloud-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/omkar-cloud~metacritic-scraper/runs": { "post": { "operationId": "runs-sync-omkar-cloud-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/omkar-cloud~metacritic-scraper/run-sync": { "post": { "operationId": "run-sync-omkar-cloud-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": { "queries": { "title": "Search Queries", "type": "array", "description": "Search phrases exactly as you would type them into the site's search box (`zelda`, `the last of us`), or pasted metacritic.com URLs: a movie, TV show or game page (`https://www.metacritic.com/movie/oppenheimer/`) is scraped in full, a search page (`/search/zelda/`) is searched. Rows carry a `search_query` field so you can tell searches apart.", "items": { "type": "string" } }, "searchType": { "title": "Search Type", "enum": [ "all", "game", "movie", "show", "person" ], "type": "string", "description": "Restrict searches to one kind.", "default": "all" }, "lists": { "title": "Lists", "uniqueItems": true, "type": "array", "description": "Which lists to scrape, for every type picked in List Types. Rows carry `source` (the list) and `list_type`. In theaters is movies only; trending is movies and TV only.", "items": { "type": "string", "enum": [ "top_rated", "new_releases", "upcoming", "in_theaters", "trending", "browse" ], "enumTitles": [ "Top rated โ€” highest Metascores (all-time, or of the Year below)", "New releases โ€” newest reviewed titles", "Upcoming โ€” not out yet, soonest first", "In theaters โ€” movies playing now", "Trending โ€” this week's trending movies & TV", "Browse โ€” every title, sorted by Sort By" ] } }, "listTypes": { "title": "List Types", "uniqueItems": true, "type": "array", "description": "Scrape each list for these kinds of titles.", "items": { "type": "string", "enum": [ "game", "movie", "show" ], "enumTitles": [ "Games", "Movies", "TV shows" ] }, "default": [ "game", "movie", "show" ] }, "year": { "title": "Year (Top rated)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Top rated only: the best titles released in this year. Leave empty for all-time." }, "yearFrom": { "title": "Year From (Browse)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Browse only: titles released in or after this year." }, "yearTo": { "title": "Year To (Browse)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Browse only: titles released in or before this year." }, "genres": { "title": "Genres", "type": "array", "description": "Only titles in these genres (lists only), matched case-insensitively. Games and movies/TV have their own genres โ€” e.g. `Action RPG`, `Open-World`, `Shooter` for games; `Comedy`, `Drama`, `Sci-Fi`, `Horror` for movies and TV.", "items": { "type": "string" } }, "platforms": { "title": "Game Platforms", "uniqueItems": true, "type": "array", "description": "Only games on these platforms (lists only; ignored for movies and TV).", "items": { "type": "string", "enum": [ "ps5", "xbox-series-x", "nintendo-switch-2", "switch", "pc", "mobile", "ps4", "xbox-one", "ps3", "xbox-360", "wii-u", "wii", "3ds", "ps-vita", "meta-quest", "ps2", "ps1", "xbox", "gamecube", "nintendo-64", "game-boy-advance", "ds", "psp", "dreamcast" ], "enumTitles": [ "PS5", "Xbox Series X/S", "Nintendo Switch 2", "Nintendo Switch", "PC", "Mobile", "PS4", "Xbox One", "PS3", "Xbox 360", "Wii U", "Wii", "3DS", "PS Vita", "Meta Quest", "PS2", "PS1", "Xbox", "GameCube", "Nintendo 64", "Game Boy Advance", "Nintendo DS", "PSP", "Dreamcast" ] } }, "networks": { "title": "Streaming Networks", "uniqueItems": true, "type": "array", "description": "Only movies and TV shows on these services (lists only; ignored for games).", "items": { "type": "string", "enum": [ "netflix", "max", "prime-video", "disney-plus", "hulu", "apple-tv", "paramount-plus", "peacock", "amazon", "itunes", "vudu", "tubi", "pluto", "plex", "starz", "criterion-channel", "discovery-plus", "fubotv", "sundance-now", "youtube-premium" ], "enumTitles": [ "Netflix", "HBO Max", "Prime Video", "Disney+", "Hulu", "Apple TV", "Paramount+", "Peacock", "Amazon (Buy/Rent)", "iTunes", "Vudu", "Tubi", "Pluto", "Plex", "Starz", "Criterion Channel", "Discovery+", "fuboTV", "Sundance Now", "YouTube Premium" ] } }, "metascoreMin": { "title": "Minimum Metascore", "minimum": 0, "maximum": 100, "type": "integer", "description": "Top rated and Browse only: skip titles scored below this (0โ€“100)." }, "sort": { "title": "Sort By (Browse)", "enum": [ "metascore", "userscore", "popularity", "newest", "oldest" ], "type": "string", "description": "Order of the Browse list.", "default": "metascore" }, "maxResultsPerQuery": { "title": "Max Results per Query", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Maximum number of titles to scrape per search query and per list (each list ร— type counts separately). Use this to control your cost (1,000 titles โ‰ˆ $1). Ignored for pasted title URLs.", "default": 30 }, "scrapeDetails": { "title": "Scrape Full Title Pages", "type": "boolean", "description": "When enabled, every movie, TV show and game found is also scraped in full โ€” the complete Metascore and user score breakdowns (positive / mixed / negative counts and sentiment), tagline, description, cast and crew with roles, studios, developers and publishers, awards, trailer, IMDb id, the featured, positive, mixed and negative critic and user reviews, related titles and news, and for games every platform with its own Metascore plus retailer prices and GameFAQs player stats. Still one dataset row per title, billed once at the detailed-title rate instead of the standard rate (1,000 detailed titles โ‰ˆ $2 vs $1 standard). Pasted title URLs are always scraped in full.", "default": false } } }, "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 } } } } } } } } } }