{ "openapi": "3.0.1", "info": { "title": "Google Play Reviews Scraper: Ratings, Replies, App Details", "description": "Scrape Google Play reviews by app link, package name or search term: star rating, text, author, date, thumbs up, app version and the developer's reply, with app name, developer, score and installs on every row. Filter by stars and date, any language and country. No login.", "version": "1.0", "x-build-id": "xhAcshfxknwOVRMiN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fernandosord~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fernandosord-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/fernandosord~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-fernandosord-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/fernandosord~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-fernandosord-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": { "apps": { "title": "Apps", "type": "array", "description": "Any mix of: a Google Play link (https://play.google.com/store/apps/details?id=com.duolingo), a package name (com.duolingo) or a search term (duolingo). A search term is replaced by the top search result, or by the top few if you raise Search results per term.", "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "type": "integer", "description": "The Actor stops at this number for each app. Google Play only lists written reviews, so an app can have far fewer reviews than ratings.", "default": 100 }, "sort": { "title": "Sort reviews by", "enum": [ "newest", "relevant", "rating" ], "type": "string", "description": "Newest first, Google's own Most relevant order, or by rating. The date cut-off stops the run early only with Newest.", "default": "newest" }, "minStars": { "title": "Min stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Only keep reviews with at least this many stars (1 to 5)." }, "maxStars": { "title": "Max stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Only keep reviews with at most this many stars (1 to 5). Set min and max to 1 for one-star reviews only." }, "reviewsNewerThan": { "title": "Only reviews newer than", "type": "string", "description": "Optional. A date (2026-01-31) or a relative period (7 days, 3 months). Older reviews are skipped." }, "language": { "title": "Language", "type": "string", "description": "Language code (en, de, es, pt-BR, ja). Google Play mostly returns reviews written in this language, and the app details in it.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code (us, gb, de, in, br). Sets the store the app details and prices come from.", "default": "us" }, "searchResultsPerTerm": { "title": "Search results per term", "minimum": 1, "maximum": 30, "type": "integer", "description": "For search terms only: how many of the top search results to scrape. 1 takes the best match.", "default": 1 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Google Play's review endpoint works without a proxy. Turn on Apify Proxy if you scrape many apps and see HTTP 429 retries in the log.", "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 } } } } } } } } } }