{ "openapi": "3.0.1", "info": { "title": "Steam Reviews Scraper", "description": "User reviews of any Steam game with full text, verdict, helpful votes, dates, purchase and Steam Deck flags and the reviewer's playtime. Filter by language, verdict, purchase type and date, add game details with price and review score, or get only new reviews.", "version": "0.1", "x-build-id": "cDC5TiibhRsi5WIQW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~steam-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-steam-reviews-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/deriverge~steam-reviews-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-steam-reviews-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/deriverge~steam-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-steam-reviews-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": { "apps": { "title": "Games", "type": "array", "description": "Steam app ids, store links or game names, in any mix. A name is looked up in the store and the first match is used.", "items": { "type": "string" } }, "queries": { "title": "Search terms", "type": "array", "description": "Search the Steam store and take the top matches of each term as games.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Maximum games per search term", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many top matches of each search term to take as games. Up to 10 come from the store's quick search; above 10 the actor reads Steam's search result pages, 25 games per page, in the order the store shows them.", "default": 10 }, "country": { "title": "Store country", "type": "string", "description": "Two-letter country code for prices and availability, for example us, gb, de, cz.", "default": "us" }, "storeLanguage": { "title": "Store language", "type": "string", "description": "Language of game descriptions, genres and categories, as Steam names it: english, german, french, czech and so on.", "default": "english" }, "maxReviewsPerApp": { "title": "Maximum reviews per game", "minimum": 1, "type": "integer", "description": "Read a hundred at a time in the order you choose. Popular games have hundreds of thousands.", "default": 200 }, "language": { "title": "Review language", "type": "string", "description": "all, or one Steam language name such as english, german, schinese, russian, french.", "default": "all" }, "reviewType": { "title": "Review type", "enum": [ "all", "positive", "negative" ], "type": "string", "description": "All reviews, only recommended, or only not recommended, filtered on the store side.", "default": "all" }, "purchaseType": { "title": "Purchase type", "enum": [ "all", "steam", "non_steam_purchase" ], "type": "string", "description": "All reviews, only from players who bought the game on Steam, or only from keys and other sources.", "default": "all" }, "sort": { "title": "Order", "enum": [ "recent", "updated", "helpful" ], "type": "string", "description": "Newest first is what a monitor wants; most helpful first is what the store page shows.", "default": "recent" }, "dayRange": { "title": "Day range for most helpful", "minimum": 1, "maximum": 365, "type": "integer", "description": "With the most helpful order, only reviews from the last N days count, up to 365." }, "publishedAfter": { "title": "Published after", "type": "string", "description": "Drop reviews written before this date (YYYY-MM-DD). With newest first the run stops at that date." }, "includeGameDetails": { "title": "Include game details", "type": "boolean", "description": "One row per game with price, genres, developers, release date, Metacritic score and the review summary. Charged per game.", "default": false }, "newOnly": { "title": "Return only rows new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only reviews that were not there before. Schedule it daily and you have a review alert that bills only for what is new.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by the new-only mode, for example \"our-games\". Runs from a saved task get a snapshot automatically even without a name." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Hard cap on returned rows in the run.", "default": 10000 } } }, "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 } } } } } } } } } }