{ "openapi": "3.0.1", "info": { "title": "Google Play Review Monitor", "description": "Watch Android apps on Google Play and get only the reviews that are new since the last check: rating, text, author_name, app_version and dev_reply_text. Run it on a schedule for alerting and support triage, with no duplicate rows.", "version": "2.1", "x-build-id": "jT0BKxsnACcPbmG9q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/herus13~google-play-review-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-herus13-google-play-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/herus13~google-play-review-monitor/runs": { "post": { "operationId": "runs-sync-herus13-google-play-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/herus13~google-play-review-monitor/run-sync": { "post": { "operationId": "run-sync-herus13-google-play-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": [ "app_ids" ], "properties": { "app_ids": { "title": "Apps to watch", "type": "array", "description": "The apps this watch checks on every run, one per entry: a Google Play package ID such as com.spotify.music, or the app's full Play Store URL such as https://play.google.com/store/apps/details?id=com.spotify.music. Required.", "items": { "type": "string" } }, "watch_id": { "title": "Watch name", "type": "string", "description": "Names this watch's saved memory. Keep the same name across scheduled runs — it is how a run knows which reviews it has already reported. The name is `default` unless you change it. A second name starts an independent watch over the same apps, which is how you reset one.", "default": "default" }, "seed_silently": { "title": "Skip the backlog on the first run", "type": "boolean", "description": "On this watch's very first run, note the reviews that already exist without reporting them, so from the second run onwards you receive only genuinely new ones. Default true. Turn it off to be sent the existing backlog once.", "default": true }, "alert_max_rating": { "title": "Only report reviews at or below this rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Report only reviews at or below this star rating, from 1 to 5; set it to 3 to hear about negative reviews only. Leave empty to report every new review. Reviews held back by this setting are still recorded, so they will not resurface later." }, "alert_only_unanswered": { "title": "Only report reviews with no developer reply", "type": "boolean", "description": "Report only reviews the developer has not answered yet, which is the queue that actually needs a person. Default false.", "default": false }, "rating_filter": { "title": "Star ratings to include", "type": "array", "description": "Keep only reviews with these star ratings, as a JSON list such as [1, 2]. Leave empty to keep every rating." }, "max_reviews_per_app": { "title": "Maximum reviews to scan per app", "minimum": 1, "maximum": 50000, "type": "integer", "description": "How far back each check looks down an app's review list, from 1 to 50000. Default 200. A check stops as soon as it reaches reviews it has already reported, so this only bites on an app that collected a burst between checks — and when more than this many arrive, the run says so in its status instead of quietly reporting less.", "default": 200 }, "country": { "title": "Country", "type": "string", "description": "Two-letter storefront code. Each country is its own review stream and is remembered separately, so one app can be watched in several countries at once without the watches interfering. Default us.", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code for the review text that comes back. Default en.", "default": "en" }, "proxyUrls": { "title": "Your own proxy URLs (optional)", "type": "array", "description": "Leave empty and the run uses a residential proxy that is included in the price of the run. To route through your own account instead, add one gateway URL per entry, for example http://user:pass@host:port. Works with DataImpulse, Bright Data, Oxylabs, Smartproxy or any provider that issues URLs. When you set this, only these URLs are used.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }