{ "openapi": "3.0.1", "info": { "title": "Google Play Scraper - App Details, Search & Reviews", "description": "Google Play scraper in one Actor: app details by package name or URL, keyword search for apps, and user reviews with sort and country. Installs, rating, histogram, price, developer, version, update date. Plain HTTP, no login.", "version": "0.1", "x-build-id": "udGbwapqowSbQFwIi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datagleaner~google-play-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datagleaner-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/datagleaner~google-play-scraper/runs": { "post": { "operationId": "runs-sync-datagleaner-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/datagleaner~google-play-scraper/run-sync": { "post": { "operationId": "run-sync-datagleaner-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": { "appIds": { "title": "App IDs or URLs (details)", "type": "array", "description": "Details mode: package names (`com.spotify.music`) or Google Play URLs (`https://play.google.com/store/apps/details?id=com.spotify.music`). Each returns one app record. Apps that do not exist in the chosen country are skipped and not charged.", "items": { "type": "string" } }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Search mode: keywords as you would type them in the Play Store, e.g. `habit tracker`. Each returns up to `maxItems` apps in store rank order (Google Play shows one page of about 20 to 30 results per query).", "items": { "type": "string" } }, "reviewAppIds": { "title": "App IDs or URLs (reviews)", "type": "array", "description": "Reviews mode: apps whose user reviews to fetch, as package names or URLs. Returns review records only (no app record), up to `maxReviews` each.", "items": { "type": "string" } }, "maxItems": { "title": "Max apps per search keyword", "minimum": 1, "maximum": 250, "type": "integer", "description": "Stops after this many apps for each keyword in `searchQueries`. Google Play returns at most about 30 results per keyword, so use several related keywords for wider coverage.", "default": 30 }, "includeDetails": { "title": "Fetch full details for search results", "type": "boolean", "description": "One extra request per search result adds rating count, histogram, version, update date, developer ID and website, full description and screenshots. Turn off for a faster list from the search cards only (title, developer, installs, rating, price, category, icon). The price per app is the same.", "default": true }, "maxReviews": { "title": "Max reviews per app", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Reviews to fetch for each app in `reviewAppIds`. Reviews are pulled 200 per request.", "default": 100 }, "reviewSort": { "title": "Review sort", "enum": [ "newest", "relevant", "rating" ], "type": "string", "description": "Order of the reviews: newest first (best for monitoring), most relevant, or by rating.", "default": "newest" }, "reviewScore": { "title": "Only reviews with this many stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Keep only reviews with exactly this star rating, e.g. `1` to monitor complaints. Leave empty for all ratings." }, "country": { "title": "Store country", "type": "string", "description": "Two-letter country code of the Play Store to read, e.g. `US`, `GB`, `DE`, `JP`. It changes prices, availability, ratings shown and which reviews appear.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Language code for store text, e.g. `en`, `de`, `ja`, `pt-BR`.", "default": "en" }, "requestDelaySecs": { "title": "Delay between requests (seconds)", "minimum": 0.1, "type": "number", "description": "Polite pacing. Lower is faster and raises the chance of being blocked.", "default": 0.5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Off by default: Google Play answered Apify datacenter IPs in testing. Enable a proxy if runs start getting blocked at high volume." } } }, "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 } } } } } } } } } }