{ "openapi": "3.0.1", "info": { "title": "Free App Store & Google Play Reviews Scraper (Classic)", "description": "Free App Store, Google Play and Chrome Web Store reviews: use app-store-google-play-reviews-scraper, app-store-reviews-scraper or google-play-reviews-scraper. Get ratings, text, versions, dates and replies; emails and phone numbers are masked on a best-effort basis. App Store feed currently limited.", "version": "0.1", "x-build-id": "QxYINUy3RdRA2s2lw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tiandu-tech~apify-002-app-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tiandu-tech-apify-002-app-reviews", "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/tiandu-tech~apify-002-app-reviews/runs": { "post": { "operationId": "runs-sync-tiandu-tech-apify-002-app-reviews", "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/tiandu-tech~apify-002-app-reviews/run-sync": { "post": { "operationId": "run-sync-tiandu-tech-apify-002-app-reviews", "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 or Chrome extensions (URL or ID)", "type": "array", "description": "Apple numeric ID / apps.apple.com URL, Google package name / play.google.com URL, or Chrome extension ID (32 letters a–p) / chromewebstore.google.com URL. Store auto-detected. Example (prefilled): WhatsApp on Google Play and uBlock Origin Lite on the Chrome Web Store. Apple App Store is temporarily limited (its public review feed sometimes returns no reviews). If apps is left out, the example apps above are used (default); the count then follows maxReviewsPerApp (default 100).", "default": [ "com.whatsapp", "ddkjiahejlhfcafbddmgiahcphecmpfh" ], "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes, e.g. us, gb. Not used for Chrome extensions (Chrome Web Store reviews are not per country).", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Language (Google Play and Chrome)", "type": "string", "description": "Apple does not support language selection; it is determined by country. For Chrome extensions, only reviews written in this language are returned.", "default": "en" }, "maxReviewsPerApp": { "title": "Max reviews per app per country (per extension for Chrome)", "minimum": 1, "type": "integer", "description": "Default 100. The form is prefilled with 5 so the example run stays small; raise it for real runs. Apple hard limit is 500 per app per country.", "default": 100 }, "includeReviewerName": { "title": "Include reviewer nickname (masked)", "type": "boolean", "description": "Off by default. When on, only the first character plus *** is output.", "default": false }, "sentiment": { "title": "Add sentiment label", "type": "boolean", "description": "Adds a simple sentiment label per review. Off by default.", "default": false }, "onlyNewSinceLastRun": { "title": "Only new reviews since last run", "type": "boolean", "description": "When on (boolean true only), later runs return only reviews newer than the last run, tracked per store, app, country and language. Off by default, so a normal run is unchanged. The first run is a full fetch (it counts toward your platform usage, limited by maxReviewsPerApp); reviews not fetched on that truncated first run are not backfilled later. Changing language, country or store starts that combination from scratch and that first run counts toward your platform usage. This option guarantees at-least-once delivery, not exactly-once.", "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 } } } } } } } } } }