{ "openapi": "3.0.1", "info": { "title": "Google Play Reviews Scraper — App Reviews by Country & Stars", "description": "[from $0.0975/1K reviews] Google Play reviews for any Android app by package id, Play Store URL or name, in several languages and countries per run: stars, text, author, date, thumbs-up, app version and developer reply. Star filter, date cutoff. No login, no API key, no run fee.", "version": "0.1", "x-build-id": "BZgwKz2YR2pLSv0NQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lergassy~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lergassy-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/lergassy~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-lergassy-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/lergassy~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-lergassy-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": "Google Play package ids, Play Store links or app names, one per line — com.spotify.music, https://play.google.com/store/apps/details?id=com.duolingo, Headspace. A name is matched to the Google Play search result whose title contains every word you typed.", "default": [ "com.spotify.music" ], "items": { "type": "string" } }, "countries": { "title": "🌍 Countries", "type": "array", "description": "Two-letter Google Play country codes — us, gb, in, br. The country changes which reviews Google ranks as most relevant and the price in the app summary; the newest-first list is the same for every country of one language, and repeats are skipped free.", "default": [ "us" ], "items": { "type": "string" } }, "languages": { "title": "đŸ—Ŗī¸ Languages", "type": "array", "description": "Review languages — en, de, es, pt-BR, hi, ja. Google Play groups reviews by language, so each language gives its own set of reviews.", "default": [ "en" ], "items": { "type": "string" } }, "sortBy": { "title": "↕ī¸ Sort reviews by", "enum": [ "newest", "relevant", "rating" ], "type": "string", "description": "The order Google Play returns reviews in. 'Newest first' is best for monitoring and for the date cutoff.", "default": "newest" }, "maxReviewsPerApp": { "title": "đŸ’¯ Reviews per app, country and language", "minimum": 1, "maximum": 20000, "type": "integer", "description": "How many reviews to collect for each app in each country and language. Google Play returns 150 per page; popular apps have thousands per language.", "default": 100 }, "minRating": { "title": "⭐ Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at least this many stars. Leave empty for all. Google Play filters on its side, so rare star values come back fast." }, "maxRating": { "title": "⭐ Maximum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at most this many stars — set 2 to collect complaints only. Leave empty for all." }, "reviewsNewerThan": { "title": "📅 Only reviews newer than", "pattern": "^(\\d{4}-\\d{2}-\\d{2}|\\d+ ?(day|days|week|weeks|month|months))$", "type": "string", "description": "A date such as 2026-09-01 or a period such as 7 days, 2 weeks, 1 month. With 'Newest first' the run stops paging as soon as it reaches older reviews — cheap daily monitoring. Leave empty for all." }, "includeAppInfo": { "title": "ℹī¸ Add an app summary row ($)", "type": "boolean", "description": "Add one row per app and country with the overall rating, number of ratings and reviews, the 1–5 star counts, installs, version, last update, developer, category and price. Off by default, so the table holds reviews only.", "default": 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 } } } } } } } } } }