{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Review Monitor", "description": "Scheduled monitor for Google Play and Apple App Store reviews. Emits only reviews that appeared since the last run, with rating filters and webhook alerts.", "version": "1.0", "x-build-id": "v8EUXtYjfFj5RFI4f" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/astraedus~app-review-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-astraedus-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/astraedus~app-review-monitor/runs": { "post": { "operationId": "runs-sync-astraedus-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/astraedus~app-review-monitor/run-sync": { "post": { "operationId": "run-sync-astraedus-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": { "apps": { "title": "Apps to monitor", "type": "array", "description": "Google Play package names (dev.astraedus.nudge), Apple numeric app IDs (284882215), or full store URLs from either store. The store is detected automatically. Left exactly as-is, this is a demo run that keeps no memory between runs, so pressing Start always returns reviews; set your own apps here to switch on real incremental monitoring.", "default": [ "dev.astraedus.nudge", "com.raeduslabs.origo", "com.raeduslabs.soulsyncapp", "com.whatsapp", "284882215" ], "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter ISO country codes for the storefronts to check, e.g. us, gb, de. Each app is checked in every country listed, and each app+country pair is billed as one 'app-checked' event. A country baked into a store URL wins for that app.", "default": [ "us" ], "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper bound on reviews emitted per app+country per run. On the very first run this is your backlog size; afterwards it only caps unusually busy days. Apple's public feed tops out at 500 reviews.", "default": 200 }, "onlyNew": { "title": "Only new reviews since the last run", "type": "boolean", "description": "Keep this on for scheduled monitoring: review IDs already emitted are remembered between runs and skipped, so you only pay for and receive genuinely new reviews. The first run for each app emits a full baseline. Turn off to re-export everything on every run.", "default": true }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only emit reviews rated at least this many stars. Leave empty for no lower bound." }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only emit reviews rated at most this many stars. Set to 2 to be alerted about angry reviews only." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. After the run, a JSON summary (per app: new review count, average rating, the worst reviews) is POSTed here. Works with Slack workflow URLs, Zapier, Make, or your own endpoint. A failing webhook never fails the run. Must be a public http(s) endpoint on the default port, with no user:password in the URL: private, loopback, link-local and internal hostnames are rejected, and redirects are followed only to addresses that pass the same check." }, "stateStoreName": { "title": "State key-value store name", "type": "string", "description": "Named key-value store holding the already-seen review IDs. Change it to run two independent monitors (for example a daily digest and a weekly report) over the same apps without them stealing each other's reviews. Ignored on the untouched demo input, which deliberately keeps its state in the run's own storage so the example always returns data.", "default": "app-review-monitor-state" }, "resetState": { "title": "Forget previously seen reviews", "type": "boolean", "description": "One-off: clears the stored review IDs for the apps in this run, so this run re-emits a full baseline. Leave off for normal scheduled use.", "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 } } } } } } } } } }