{ "openapi": "3.0.1", "info": { "title": "Google Play Reviews & App Details Scraper", "description": "Scrape Google Play reviews (stars, text, date, likes, developer replies, app version) and app details (rating, histogram, installs, price, developer email) by package name, URL or search term. Fast, cheap, HTTP-only.", "version": "1.0", "x-build-id": "6bp7KA46mAIdxqAhT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zkill3r~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zkill3r-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/zkill3r~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-zkill3r-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/zkill3r~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-zkill3r-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": { "appIds": { "title": "Apps", "type": "array", "description": "Apps to scrape: package names (com.whatsapp) or full Google Play URLs (https://play.google.com/store/apps/details?id=com.whatsapp). Invalid entries are skipped with a warning.", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Optional. Each term is searched on Google Play and the top results are added as apps to scrape, e.g. \"budget planner\".", "items": { "type": "string" } }, "maxAppsPerSearch": { "title": "Apps per search term", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many top search results to scrape for each search term.", "default": 5 }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code (gl), e.g. us, gb, my, in. Affects which reviews, prices and availability you see.", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Language code (hl), e.g. en, ms, pt-BR. Reviews are returned in this language where available.", "default": "en" }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to save per app. 0 = all reviews Google Play makes available.", "default": 100 }, "sort": { "title": "Sort reviews by", "enum": [ "newest", "most_relevant", "rating" ], "type": "string", "description": "Order in which reviews are fetched. \"Newest\" is required for \"Reviews since\" to stop paging early.", "default": "newest" }, "filterByStars": { "title": "Only reviews with stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Only return reviews with exactly this star rating (1-5). Leave empty for all ratings." }, "reviewsSince": { "title": "Reviews since", "type": "string", "description": "Optional ISO date (e.g. 2026-10-01). Only reviews on or after this date are saved; with sort \"Newest\", paging stops as soon as older reviews appear." }, "includeAppDetails": { "title": "Include app details", "type": "boolean", "description": "Also save one app item per app (title, rating, histogram, installs, price, developer contact, version...).", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many requests run in parallel. Lower it if you see many 429 retries in RUN_SUMMARY.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Apify datacenter proxy works for most runs; switch to RESIDENTIAL if you see many 429 or consent-page retries.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }