{ "openapi": "3.0.1", "info": { "title": "Google Play Scraper - Reviews, App Details & Search $0.10/1K", "description": "$0.10 per 1,000 reviews. Scrape Google Play reviews with developer replies and app versions, sort, star and date filters, and monitor mode returning only new reviews. Plus app details with installs, rating histogram and similar apps, and keyword search. No reviewer names.", "version": "0.1", "x-build-id": "nDBQSSE8bxnhrwSUs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zhyou~google-play-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zhyou-google-play-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/zhyou~google-play-scraper/runs": { "post": { "operationId": "runs-sync-zhyou-google-play-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/zhyou~google-play-scraper/run-sync": { "post": { "operationId": "run-sync-zhyou-google-play-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": { "mode": { "title": "What to scrape", "enum": [ "reviews", "apps", "search" ], "type": "string", "description": "Reviews of apps, full app details or keyword search results.", "default": "reviews" }, "appIds": { "title": "Apps", "type": "array", "description": "Reviews and App details modes. Package names (e.g. com.whatsapp) or Google Play URLs (https://play.google.com/store/apps/details?id=com.whatsapp), one per line.", "default": [ "com.whatsapp" ], "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keyword search mode. One keyword per line.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Google Play countries as 2-letter codes (us, gb, de, jp, ...). App details and search run in every country (price, currency and availability differ). Reviews depend on the language, not the country, so reviews use the first country only.", "default": [ "us" ], "items": { "type": "string" } }, "languages": { "title": "Languages", "type": "array", "description": "Language codes (en, de, es, pt-BR, ja, ...). Google Play groups reviews by language: en returns English reviews from all countries, de returns German reviews. Every app (and search term) is scraped in every language. Details and search text are returned in this language.", "default": [ "en" ], "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app and language", "minimum": 0, "type": "integer", "description": "0 = all reviews Google Play serves.", "default": 100 }, "reviewSort": { "title": "Sort reviews by", "enum": [ "recent", "relevant", "rating" ], "type": "string", "description": "Google Play's own sort orders.", "default": "recent" }, "reviewsSince": { "title": "Only reviews since", "type": "string", "description": "Optional. YYYY-MM-DD, or -N for the last N days (e.g. -30). With Newest sorting the scraper stops paging at this date." }, "minRating": { "title": "Min stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only reviews with at least this many stars.", "default": 1 }, "maxRating": { "title": "Max stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only reviews with at most this many stars, e.g. 2 for complaints only. Set min and max to the same value (e.g. 1 and 1) to let Google filter, which is fastest.", "default": 5 }, "monitorMode": { "title": "Monitor mode: only new reviews", "type": "boolean", "description": "Remembers which reviews were delivered (per monitor key, app, language, country and star filter). Schedule the Actor and every run returns only reviews posted since the last run. Uses Newest sorting.", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Name of the watch list. Use different keys for independent schedules.", "default": "default" }, "maxResultsPerTerm": { "title": "Max results per search term", "minimum": 1, "maximum": 50, "type": "integer", "description": "Keyword search mode. Google Play shows about 30 apps per search (20 when an exact match is highlighted) and no further pages.", "default": 30 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel requests. Lower it if you see many retries.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Every request goes out through a fresh Apify Proxy IP and is retried on another IP if Google rate-limits it. Datacenter proxies are the default.", "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 } } } } } } } } } }