{
"openapi": "3.0.1",
"info": {
"title": "Google Play Review Monitor — Alerts for New App Reviews",
"description": "Watch Google Play apps and get only the reviews that are NEW since the last check. Run it on a schedule for review alerting, support triage, and rating-drop detection — no re-reading the same reviews, no duplicate rows.",
"version": "2.0",
"x-build-id": "3a4DzKPIvqcxIf5Jw"
},
"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": "Google Play package IDs or full Play Store URLs — e.g. com.spotify.music or https://play.google.com/store/apps/details?id=com.spotify.music. These are the apps this watch checks on every run.",
"items": {
"type": "string"
}
},
"watch_id": {
"title": "Watch name",
"type": "string",
"description": "Names this watch's saved state. Keep it the SAME across scheduled runs — that is how the actor knows which reviews it has already reported. Change it (or use a second name) to run an independent watch over the same apps.",
"default": "default"
},
"seed_silently": {
"title": "Skip the backlog on the first run",
"type": "boolean",
"description": "On the very first run this watch records the reviews that already exist WITHOUT reporting them, so you only get genuinely new ones from run two onward. Turn this off to receive the current backlog once.",
"default": true
},
"alert_max_rating": {
"title": "Only report reviews at or below this rating",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "Set to 3 to be alerted only about negative reviews. Leave empty to report every new review."
},
"alert_only_unanswered": {
"title": "Only report reviews with no developer reply",
"type": "boolean",
"description": "Useful for support triage — surfaces reviews still waiting on a response.",
"default": false
},
"rating_filter": {
"title": "Star ratings to include",
"type": "array",
"description": "Restrict to specific star ratings, e.g. [1, 2]. Leave empty for all."
},
"max_reviews_per_app": {
"title": "Maximum reviews to scan per app",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "How deep to walk on each check. The walk stops early as soon as it reaches reviews it has already seen, so this is only a ceiling for apps that received a burst of reviews between checks.",
"default": 200
},
"country": {
"title": "Country",
"type": "string",
"description": "Two-letter storefront code. Each country is a separate review stream and is tracked separately.",
"default": "us"
},
"language": {
"title": "Language",
"type": "string",
"description": "Two-letter language code for review text.",
"default": "en"
},
"transport": {
"title": "HTTP transport",
"enum": [
"auto",
"httpx",
"curl_cffi",
"primp"
],
"type": "string",
"description": "Leave on auto unless debugging.",
"default": "auto"
},
"proxyProvider": {
"title": "Proxy provider",
"enum": [
"default",
"dataimpulse",
"apify",
"custom",
"disabled"
],
"type": "string",
"description": "Default routes the run through DataImpulse residential IPs (falling back to Apify Proxy) and is included in the price of the run. Custom uses the proxy URLs you enter below; Apify Proxy uses the proxy configuration below; No proxy connects directly. Leave this empty to keep the behaviour this actor already had — nothing is imposed on a run that does not choose."
},
"proxyUrls": {
"title": "Custom proxy URLs",
"type": "array",
"description": "Only read when Proxy provider is Custom. One gateway URL per entry, e.g. http://user:pass@host:port — works with any provider that issues URLs (BrightData, Oxylabs, SmartProxy, your own). Leave empty for any other Proxy provider.",
"items": {
"type": "string"
}
},
"proxy": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional. Google Play does not require a proxy for normal volumes."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}