{ "openapi": "3.0.1", "info": { "title": "Metacritic Reviews & Scores Scraper", "description": "Scrape Metacritic titles, Metascores, user scores, review counts, release details, rankings, summaries, and review snippets.", "version": "0.1", "x-build-id": "WB5OgEF041Kbaz31O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~metacritic-reviews-scores-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-metacritic-reviews-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/fetch_cat~metacritic-reviews-scores-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-metacritic-reviews-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/fetch_cat~metacritic-reviews-scores-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-metacritic-reviews-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Metacritic browse, search, or title detail URLs. A nonempty query adds a search alongside these URLs. With neither URLs nor query, browse the selected category. Only the supplied listing pages are inspected; no exhaustive pagination.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "query": { "title": "Search query", "type": "string", "description": "Optional public Metacritic search term, such as a movie, game, show or album name. Adds a search alongside Start URLs; Category does not filter search results. Clear Start URLs for search only." }, "category": { "title": "Category", "enum": [ "movie", "tv", "game", "music" ], "type": "string", "description": "Browse this category only when both Start URLs and Search query are empty. Does not filter supplied URLs or search results.", "default": "movie" }, "browseSort": { "title": "Browse sort context", "enum": [ "metascore", "user_score", "newest", "popular" ], "type": "string", "description": "Accepted setting with no effect on requests, output context or sorting. To select a ranking, provide the exact Metacritic browse URL. Results are not sorted by this field.", "default": "metascore" }, "maxItems": { "title": "Maximum titles", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of Metacritic title records to save.", "default": 5 }, "includeReviews": { "title": "Include review snippets", "type": "boolean", "description": "Fetch public critic and user review pages for each title and include short snippets.", "default": false }, "year": { "title": "Year context", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Accepted setting with no effect on requests, filtering or output. For a year-specific selection, provide an exact Metacritic browse URL that already contains that selection." }, "maxReviewSnippets": { "title": "Review snippets per type", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum critic snippets and maximum user snippets to collect for each title when Include review snippets is enabled.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Connection settings used from the first request, not a direct-first fallback. Default: Apify Proxy with automatic group selection. You may supply your own proxy URLs or select no proxy; explicit settings are passed through unchanged. No automatic switch to another group or provider occurs on failure. Omitted input uses the existing SDK proxy configuration. Do not include credentials in support reports.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } } } }, "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 } } } } } } } } } }