{ "openapi": "3.0.1", "info": { "title": "Google Play Reviews Scraper — Ratings, Versions & Countries", "description": "Every review Google Play serves for any Android app, in any country and language: stars, text, app version, helpful votes, developer reply and date, one row per review. Or one summary row per app and country with Google's star histogram, installs and review velocity. No login, no key, no proxies.", "version": "1.0", "x-build-id": "n1vBTgFPlHqCZo2zH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidyfeed~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidyfeed-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/tidyfeed~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-tidyfeed-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/tidyfeed~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-tidyfeed-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", "required": [ "apps" ], "properties": { "apps": { "title": "Apps", "type": "array", "description": "Google Play links or package names. https://play.google.com/store/apps/details?id=com.whatsapp and com.whatsapp both work. The country in a link (gl=) is used when the Countries field below is left empty.", "items": { "type": "string" } }, "countries": { "title": "Countries (Google Play storefronts)", "type": "array", "description": "Two-letter country codes: us, gb, de, fr, jp, kr, br, in… Each app is read from every country listed, so 2 apps × 3 countries = 6 sets of reviews. The review language follows the country (kr → Korean, de → German) unless you set one below. Leave empty to use the country from each link, or the US store for bare package names.", "items": { "type": "string" } }, "language": { "title": "Review language (optional)", "type": "string", "description": "Two-letter language code to use for every country, e.g. en. Leave empty to let each country use its own main language.", "default": "" }, "mode": { "title": "What to return", "enum": [ "reviews", "summary" ], "type": "string", "description": "\"Reviews\" gives one row per review. \"Summary\" gives one row per app and country: Google's average rating, rating count and 1-to-5 star histogram, installs, the version on sale, and the rating split, velocity and developer-reply rate of the most recent reviews.", "default": "reviews" }, "sortBy": { "title": "Review order", "enum": [ "newest", "helpful" ], "type": "string", "description": "Newest first is the one to use for tracking; most helpful surfaces the reviews other users voted up.", "default": "newest" }, "daysBack": { "title": "Only reviews from the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Leave at 0 for no date filter. Set 7 or 30 to track what came in since the last run. Works with newest-first order.", "default": 0 }, "maxReviewsPerApp": { "title": "Max reviews per app and country", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Upper limit for each app in each country. Google Play pages in batches of about 150 and goes back years for big apps, so the cap is what keeps a run short.", "default": 100 } } }, "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 } } } } } } } } } }