{ "openapi": "3.0.1", "info": { "title": "Google Play Reviews Scraper – Ratings, Text, Replies, No API", "description": "Google Play Reviews Scraper for any Android app: star rating, full text, date, app version, helpful votes and developer replies, plus app installs and score on every row. Filter by stars, several languages, no API key or login. Built for ASO, product and sentiment analysis.", "version": "1.0", "x-build-id": "Mqtjc6rUudLYW0zoE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nourishing_courier~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nourishing_courier-google-play-reviews-scraper", "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/nourishing_courier~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-nourishing_courier-google-play-reviews-scraper", "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/nourishing_courier~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-nourishing_courier-google-play-reviews-scraper", "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": "Google Play apps", "type": "array", "description": "Android package names (com.whatsapp) or Google Play URLs (https://play.google.com/store/apps/details?id=com.whatsapp). One app per line.", "default": [ "com.whatsapp" ], "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Maximum reviews per app", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Cap per app and language. Google Play returns the full review history, newest first, so this can go up to 20,000.", "default": 200 }, "language": { "title": "Review language", "type": "string", "description": "Language code of the reviews to collect, e.g. en, de, es, fr, sv, pt-BR. Google Play keeps reviews per language.", "default": "en" }, "languages": { "title": "Several languages (optional)", "type": "array", "description": "Optional. Collect each app in several languages in one run, e.g. en, de, fr, es. When filled, this replaces the single language above; the review cap applies per language.", "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "Two-letter Google Play country code (gl), e.g. us, gb, de, in. Affects the app details and which reviews Play considers local.", "default": "us" }, "sortBy": { "title": "Sort by", "enum": [ "newest", "relevant", "rating" ], "type": "string", "description": "Applied natively by Google Play, exactly like the sort menu on the store page. 'Newest' for monitoring, 'Most relevant' for Play's default helpfulness-weighted order, 'Rating' for highest stars first.", "default": "newest" }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews at or above this many stars. Narrower star ranges use Google Play's own star filter, so min 1 / max 1 fetches 1-star reviews directly instead of paging past the rest.", "default": 1 }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews at or below this many stars.", "default": 5 }, "onlyWithText": { "title": "Only reviews with text", "type": "boolean", "description": "Skip star-only ratings that carry no written feedback.", "default": false }, "includeAppDetails": { "title": "Add app details to every row", "type": "boolean", "description": "Fetch the app's name, developer, install count, overall score, ratings count and genre once per app and add them as appName, appDeveloper, appInstalls, appRating, appRatingsCount, appGenre on each review. Costs nothing extra.", "default": true }, "concurrency": { "title": "Parallel apps", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many apps to fetch at once. Lower this if Google Play starts rate limiting you.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Google Play does not need a proxy at normal volumes; turn one on only for very large batches that start hitting rate limits.", "default": { "useApifyProxy": 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 } } } } } } } } } }