{ "openapi": "3.0.1", "info": { "title": "Google Play Reviews Scraper Pro", "description": "Extract Google Play app reviews with ratings, full text, dates, thumbs up counts, app versions and developer replies. Filter by date and rating, sort four ways, choose language and country, and get a per-app analytics summary with the full star distribution.", "version": "0.0", "x-build-id": "6UYHDlOoSsaxicQEa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/goldenbios~my-actor-2/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-goldenbios-my-actor-2", "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/goldenbios~my-actor-2/runs": { "post": { "operationId": "runs-sync-goldenbios-my-actor-2", "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/goldenbios~my-actor-2/run-sync": { "post": { "operationId": "run-sync-goldenbios-my-actor-2", "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": { "appIds": { "title": "App IDs or Play Store URLs", "type": "array", "description": "Android apps to scrape reviews from: package names (e.g. com.whatsapp) and/or Google Play Store URLs (the id= parameter is read from the URL). Each app is processed in order.", "default": [], "items": { "type": "string" } }, "country": { "title": "Country (gl)", "type": "string", "description": "2-letter country code sent to Google Play (gl), e.g. us, fr, de, ma. Google serves the review stream for that storefront country.", "default": "us" }, "includeSummary": { "title": "Include per-app summary", "type": "boolean", "description": "Emit one summary item per app: reviews fetched, emitted, filtered out, average rating, the 1-5 star distribution, and why fetching stopped.", "default": true }, "language": { "title": "Language (hl)", "type": "string", "description": "Language code for the review stream (hl), e.g. en, fr, de, es, ar. Reviews are returned in the original languages users wrote them; this steers the storefront locale.", "default": "en" }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Only reviews with at most this star rating (1-5)." }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "type": "integer", "description": "Maximum reviews emitted per app, after filters. Fetching stops once the cap is reached.", "default": 100 }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Only reviews with at least this star rating (1-5)." }, "onlyWithDeveloperReply": { "title": "Only reviews with a developer reply", "type": "boolean", "description": "Keep only reviews the developer has publicly replied to.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The Play Store reviews endpoint is a public web endpoint. Apify Proxy (standard) is the prepared default and is normally enough; switch to RESIDENTIAL only if you see repeated HTTP 403 errors. You pay only your own run's proxy usage; traffic is one small request per 100 reviews." }, "reviewsEndDate": { "title": "Reviews end date", "type": "string", "description": "Only reviews dated on or before this day (inclusive, UTC)." }, "reviewsStartDate": { "title": "Reviews start date", "type": "string", "description": "Only reviews dated on or after this day (inclusive, UTC). With the newest sort order, fetching stops as soon as the stream passes this date." }, "sortOrder": { "title": "Sort order", "enum": [ "newest", "mostRelevant", "highestRating", "lowestRating" ], "type": "string", "description": "Review order. newest, mostRelevant and highestRating are Google's native streams. lowestRating is built from the newest stream and re-sorted ascending, because Google's public endpoint has no native lowest-first stream (see the README's honest limits).", "default": "newest" } } }, "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 } } } } } } } } } }