{ "openapi": "3.0.1", "info": { "title": "App Review Monitor · App Store & Google Play", "description": "Scrape and monitor app reviews from the Apple App Store and Google Play in one run. Normalized output, rating summaries, and incremental monitoring that returns only new reviews on every scheduled run.", "version": "0.1", "x-build-id": "Thycs3bDiBBsMhUWB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thisizkp~app-review-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thisizkp-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/thisizkp~app-review-monitor/runs": { "post": { "operationId": "runs-sync-thisizkp-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/thisizkp~app-review-monitor/run-sync": { "post": { "operationId": "run-sync-thisizkp-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", "required": [ "apps" ], "properties": { "apps": { "title": "Apps", "type": "array", "description": "Apps to scrape, in any of these formats: App Store URL (https://apps.apple.com/us/app/slack/id618783545), Google Play URL (https://play.google.com/store/apps/details?id=com.Slack), numeric Apple app ID (618783545), or Android package name (com.Slack). Mix both platforms freely — the platform is detected automatically.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes of the app stores to check (ISO 3166-1, e.g. us, gb, de, in). Each app is checked in every listed country.", "default": [ "us" ], "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app per country", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper limit of reviews scraped for each app + country combination. Note: Apple's public feed exposes at most ~500 recent reviews per country; Google Play allows going much deeper.", "default": 200 }, "sort": { "title": "Sort order", "enum": [ "newest", "helpfulness", "rating" ], "type": "string", "description": "Order in which reviews are fetched. 'Rating' is supported on Google Play only — Apple falls back to newest first.", "default": "newest" }, "ratingFilter": { "title": "Rating filter", "enum": [ "all", "negative", "neutral", "positive" ], "type": "string", "description": "Only keep reviews in the selected rating band. Useful for monitoring negative feedback.", "default": "all" }, "reviewsAfterDate": { "title": "Only reviews after", "type": "string", "description": "Skip reviews written before this date (UTC). Leave empty to keep everything up to the max limit." }, "language": { "title": "Language (Google Play)", "type": "string", "description": "Two-letter language code for Google Play reviews (the Apple feed is per-country and ignores this). Default: en.", "default": "en" }, "monitoringMode": { "title": "Monitoring mode (only new reviews)", "type": "boolean", "description": "Remember which reviews were already scraped (in a named key-value store) and output only new ones on subsequent runs.", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Name of the key-value store that holds the seen-review state for monitoring mode. Use different names to run independent monitors.", "default": "app-review-monitor-state" }, "includeRatingSummary": { "title": "Include rating summaries", "type": "boolean", "description": "Push one summary record per app + country with the average rating, total rating count, and (on Google Play) the star histogram.", "default": true }, "failIfNoReviews": { "title": "Fail when a source returns nothing", "type": "boolean", "description": "Make the run FAIL if any checked app + country returns zero reviews (before filters) or errors. Useful for scheduled health checks with failure notifications; leave off for normal scraping.", "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 } } }, "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 } } } } } } } } } }