{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews Scraper", "description": "Scrape Apple App Store and Google Play reviews into one JSON schema. Only-new mode for scheduled monitoring, a clean stop at your budget, no browser.", "version": "0.1", "x-build-id": "3Sq6q8vSRMhb6Fr7l" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/notabotpromise~app-review-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-notabotpromise-app-review-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/notabotpromise~app-review-monitor/runs": { "post": { "operationId": "runs-sync-notabotpromise-app-review-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/notabotpromise~app-review-monitor/run-sync": { "post": { "operationId": "run-sync-notabotpromise-app-review-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", "properties": { "appStoreApps": { "title": "App Store apps", "type": "array", "description": "Numeric App Store IDs or App Store links. The country inside a link is ignored; Countries decides the storefronts. Leave empty to read only Google Play.", "items": { "type": "string" } }, "googlePlayApps": { "title": "Google Play apps", "type": "array", "description": "Google Play package names or Play Store links. Package names are case-sensitive. Leave empty to read only the App Store.", "items": { "type": "string" } }, "countries": { "title": "Countries", "minItems": 1, "type": "array", "description": "Two-letter storefront codes. Each app is read once per country. The App Store returns at most the 500 newest reviews per country.", "items": { "type": "string", "pattern": "^\\s*[A-Za-z]{2}\\s*$" }, "default": [ "us" ] }, "language": { "title": "Google Play language", "pattern": "^[a-z]{2}(-[A-Z]{2})?$", "type": "string", "description": "Google Play only. App Store reviews are returned in the language reviewers wrote.", "default": "en" }, "maxReviewsPerApp": { "title": "Maximum reviews per app and country", "minimum": 1, "type": "integer", "description": "Newest reviews to deliver per app and country (and language on Google Play). Each review costs $0.0005. The App Store caps this at 500 per country.", "default": 100 }, "onlyNewSinceLastRun": { "title": "Only new reviews since the last run", "type": "boolean", "description": "Deliver only reviews that no earlier run of this Actor in your account delivered for the same app and country. Intended for schedules. After a budget stop or a failed app, the next run continues where it stopped; an aborted, timed-out or migrated run can repeat at most the page it was writing. If more new reviews arrive than the maximum per app, only the newest are delivered. Dates and review IDs are kept in app-review-monitor-state.", "default": false }, "includeUserImage": { "title": "Include reviewer avatar URLs", "type": "boolean", "description": "Adds the reviewer's avatar URL for Google Play. This is personal data; leave it off unless you need it.", "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 } } } } } } } } } }