{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews Scraper", "description": "Scrape reviews and app stats from Google Play and the App Store in one run. Many apps and countries, developer replies, and an incremental mode that only returns new reviews on scheduled runs.", "version": "0.1", "x-build-id": "lmcul646TYJG2VdS8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plainscrape~app-reviews-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plainscrape-app-reviews-monitor", "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/plainscrape~app-reviews-monitor/runs": { "post": { "operationId": "runs-sync-plainscrape-app-reviews-monitor", "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/plainscrape~app-reviews-monitor/run-sync": { "post": { "operationId": "run-sync-plainscrape-app-reviews-monitor", "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": [ "apps" ], "properties": { "apps": { "title": "Apps", "type": "array", "description": "App Store or Google Play URLs, Apple numeric ids, or Android package names. Mix both stores freely.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter store country codes. Each app is fetched once per country.", "default": [ "us" ], "items": { "type": "string" } }, "languages": { "title": "Languages (Google Play)", "type": "array", "description": "Google Play review languages, e.g. en, de, he. Ignored for the App Store.", "default": [ "en" ], "items": { "type": "string" } }, "sort": { "title": "Sort", "enum": [ "recent", "helpful" ], "type": "string", "description": "recent = newest first (required for incremental mode); helpful = most helpful first.", "default": "recent" }, "maxReviewsPerApp": { "title": "Max reviews per app and country", "minimum": 0, "type": "integer", "description": "0 = everything available. The App Store feed never returns more than 500 per app and country.", "default": 500 }, "onlyNewReviews": { "title": "Only new reviews (incremental)", "type": "boolean", "description": "Remember the newest reviews seen per app and country and emit only reviews that are new since the last run. Ideal for scheduled monitoring.", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Named key-value store that keeps the incremental state. Use different names for independent monitors.", "default": "app-reviews-monitor-state" }, "sinceDate": { "title": "Only reviews since", "type": "string", "description": "ISO date, e.g. 2026-09-01. Stops paging once older reviews are reached (sort=recent)." }, "minRating": { "title": "Min rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep reviews with at least this many stars.", "default": 1 }, "maxRating": { "title": "Max rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep reviews with at most this many stars.", "default": 5 }, "includeAppDetails": { "title": "Include app snapshot", "type": "boolean", "description": "Also write one app record per app and country: rating, rating count, installs, version, last update.", "default": true }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel app/country tasks.", "default": 4 } } }, "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 } } } } } } } } } }