{ "openapi": "3.0.1", "info": { "title": "Google Play Reviews Scraper: App Reviews, Ratings & Replies", "description": "Scrape Google Play app reviews by package name or store URL: reviewer, star rating, full text, date, app version, thumbs-up count, per-aspect ratings and the developer's reply. Sort three ways, filter by stars, language, country and date. No API key, no proxies, no browser.", "version": "0.0", "x-build-id": "Id4taCEg7dFV1qS0j" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arman-bd~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arman-bd-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/arman-bd~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-arman-bd-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/arman-bd~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-arman-bd-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": [ "appIds" ], "properties": { "appIds": { "title": "Apps", "type": "array", "description": "The apps to read reviews from, one per line. Accepts a package name (com.spotify.music), any store URL (https://play.google.com/store/apps/details?id=com.spotify.music), or an Android market:// link. Each app is read independently, so two apps cost roughly twice one. A typo'd package name is reported as \"app not found\" in the run summary rather than silently returning nothing.", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "newest", "mostRelevant", "rating" ], "type": "string", "description": "The order reviews are read in, which decides what a capped run contains. \"Newest first\" reads the most recent reviews and is the one order where a date range stops the run early at the boundary. \"Most relevant\" is the store's own default ranking - detailed, heavily-upvoted reviews first, which is what a person sees on the app page. \"Rating\" reads highest-rated first.", "default": "newest" }, "starRatings": { "title": "Only these star ratings", "type": "array", "description": "Keep only reviews with these exact star ratings, e.g. just 1-star to read complaints, or 1 and 2 to monitor problems. The filtering happens at the source, so a 1-star pull from a well-loved app does not page through thousands of 5-star reviews to find them - each selected star is fetched directly. Leave empty for all ratings. The cap on reviews per app applies to the app as a whole, not per star.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] }, "default": [] }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Cap on reviews saved for each app, and the main cost control since charging is per review. Popular apps carry millions of reviews, so a run without a sensible cap can be long and expensive. The run stops early when an app has fewer reviews than the cap, and the per-app numbers in the run summary say which happened.", "default": 200 }, "language": { "title": "Review language", "type": "string", "description": "Which language edition of the reviews to read, as the store's own language code: en, de, fr, ja, pt-BR and so on. This selects the store's language grouping rather than detecting the language of each text - reviewers who wrote in another language from a device set to this one still appear.", "default": "en" }, "country": { "title": "Storefront country", "type": "string", "description": "Two-letter storefront code such as us, gb, de or in. Availability and the review pool shift with it, so reading the same app from two storefronts returns overlapping but not identical sets.", "default": "us" }, "dateFrom": { "title": "Written after", "type": "string", "description": "Oldest review to keep. Absolute as 2026-01-15, or relative as \"30 days\", \"36 hours\", \"6 months\". Applied exactly to each review's own timestamp. With sort \"Newest first\" the run also stops paging the moment it crosses this boundary, which makes it the cheap way to say \"reviews from the last month\"; the other sorts apply the same filter but read on to the cap to apply it." }, "dateTo": { "title": "Written before", "type": "string", "description": "Newest review to keep, in the same formats. A bare date like 2026-06-01 keeps the whole of that day. Ignored unless \"Written after\" is also set, because a range needs a start; the run says so in the log when that happens." } } }, "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 } } } } } } } } } }