{ "openapi": "3.0.1", "info": { "title": "Steam Reviews Scraper - With Playtime Data", "description": "Scrape Steam reviews with the hours the player had when writing them, how long they kept playing afterwards, the early access flag, and whether they bought the game on Steam or received it. Filter by language and minimum playtime. No API key needed.", "version": "0.1", "x-build-id": "g9R49sDvHqqUldH0x" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataio~steam-reviews-playtime-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataio-steam-reviews-playtime-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/dataio~steam-reviews-playtime-scraper/runs": { "post": { "operationId": "runs-sync-dataio-steam-reviews-playtime-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/dataio~steam-reviews-playtime-scraper/run-sync": { "post": { "operationId": "run-sync-dataio-steam-reviews-playtime-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", "required": [ "appIds" ], "properties": { "appIds": { "title": "Steam app IDs", "minItems": 1, "maxItems": 30, "type": "array", "description": "The number in a Steam URL: store.steampowered.com/app/1091500/ is 1091500. Up to 30 games per run.", "items": { "type": "string" } }, "reviewsPerGame": { "title": "Reviews per game", "minimum": 1, "maximum": 5000, "type": "integer", "description": "100 per request, paginated by cursor. Popular games have hundreds of thousands of reviews, so this is a sample — which order you take it in matters more than how many.", "default": 300 }, "sortBy": { "title": "Sort by", "enum": [ "recent", "updated", "helpful" ], "type": "string", "description": "Most recent is what players are saying now. Most helpful surfaces the reviews the community voted up — those have vote counts, recent ones almost never do.", "default": "recent" }, "reviewType": { "title": "Review type", "enum": [ "all", "positive", "negative" ], "type": "string", "description": "Negative only is the fastest route to what is actually wrong.", "default": "all" }, "minPlaytimeHours": { "title": "Minimum playtime at review (hours)", "minimum": 0, "type": "integer", "description": "The whole point of this Actor. Set 50 and you read only players who actually know the game; measured on Cyberpunk 2077, that group rates it 97% positive against 88% for players under 10 hours." }, "language": { "title": "Language", "type": "string", "description": "Steam language code: english, french, german, schinese, russian, brazilian. Leave as all for every language — reviews are returned in their original language, untranslated.", "default": "all" }, "purchaseType": { "title": "Purchase type", "enum": [ "all", "steam", "other" ], "type": "string", "description": "Steam purchases only excludes third-party keys, which are more often review-bombed or given away.", "default": "all" }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Steam only honours this server-side with the Most helpful sort; with the other sorts it is applied to the results instead." }, "maxItems": { "title": "Maximum reviews", "minimum": 1, "maximum": 50000, "type": "integer", "description": "One row per review, across all games.", "default": 1000 } } }, "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 } } }, "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 } } } } } } } } } }