{ "openapi": "3.0.1", "info": { "title": "Google Play Reviews Scraper: Developer Replies & App Details", "description": "Get Google Play reviews with star ratings, text, app versions, thumbs-up counts, developer replies and feature ratings in any language, plus app details with installs and star histogram.", "version": "0.1", "x-build-id": "0fG3ylTrdA2vZB2IY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stratumics~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stratumics-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/stratumics~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-stratumics-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/stratumics~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-stratumics-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 apps to scrape. Paste links (https://play.google.com/store/apps/details?id=com.instagram.android) or package names (com.instagram.android, the id= part of the link). One per line.", "items": { "type": "string" } }, "languages": { "title": "Review languages", "type": "array", "description": "Language codes such as en, de, es, pt or zh-TW. Google Play groups reviews by language (the same English reviews show up in the US, the UK and India), so each app is read once per language. Leave empty to use the hl= language of each app link, or English.", "default": [], "items": { "type": "string" } }, "country": { "title": "Store country", "type": "string", "description": "Two-letter country code such as us, gb or in. It sets the price, currency and availability shown in the app details record; it does not change which reviews you get. Leave empty to use the gl= country of each app link, or the United States.", "default": "" }, "maxReviewsPerApp": { "title": "Max reviews per app and language", "minimum": 0, "maximum": 100000, "type": "integer", "description": "The most reviews to collect for each app in each language. Google Play has no fixed limit, so this can go into the tens of thousands for popular apps. Set 0 to collect only the app details record.", "default": 200 }, "sort": { "title": "Sort by", "enum": [ "newest", "mostRelevant", "rating" ], "type": "string", "description": "Order in which reviews are read. Newest first is the only order that the date cut-off and monitoring can stop on.", "default": "newest" }, "stars": { "title": "Star ratings", "type": "array", "description": "Keep only reviews with these star ratings, for example 1 and 2 for complaints. Leave empty for all ratings. You only pay for reviews that match.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] }, "default": [] }, "newerThan": { "title": "Only reviews newer than", "pattern": "^$|^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?(Z|[+-][0-2]\\d:?[0-5]\\d)?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$", "type": "string", "description": "Keep reviews posted (or last edited) on or after this date. Use a date (2026-10-01), an ISO date-time in UTC (2026-10-01T12:00:00Z), or a relative value such as \"30 days\" or \"12 hours\". With newest first, reading stops at the first older review, so you only pay for what is in the range. Leave empty for no limit.", "default": "" }, "onlyNewReviews": { "title": "Only new reviews (monitoring mode)", "type": "boolean", "description": "Remember the reviews delivered for each app and language and, on later runs, return only reviews you have not received yet. The first run returns the newest reviews up to your limit. Run it on a schedule to follow apps; it always reads newest first.", "default": false }, "monitorName": { "title": "Monitor name", "pattern": "^[A-Za-z0-9][A-Za-z0-9-]{0,29}$", "type": "string", "description": "Name of the memory used by monitoring mode, kept in a key-value store of your account. Runs with the same name share it, so use one name per schedule. Letters, digits and hyphens only.", "default": "default" }, "includeAppDetails": { "title": "Add an app details record", "type": "boolean", "description": "Add one record per app with the name, developer, average rating, number of ratings and written reviews, star histogram, price, category, current version, last update, release date and installs.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google Play answers without a proxy, so none is used by default. If Google starts throttling, the scraper switches to Apify datacenter proxy by itself. Choose a proxy here to use it for every request.", "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 } } } } } } } } } }