{ "openapi": "3.0.1", "info": { "title": "Google Play Apps Scraper", "description": "Apps, keyword search and developer catalogues from the Google Play Store. Publishes both of the rating counts Google ships — they disagree by up to 6% — and refuses an unknown storefront country rather than letting Google price the app from your exit IP.", "version": "0.1", "x-build-id": "hm7QL8iGmhz0tbQDj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~googleplay-apps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-googleplay-apps-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/scrapyx~googleplay-apps-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-googleplay-apps-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/scrapyx~googleplay-apps-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-googleplay-apps-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 collect", "enum": [ "apps", "search", "developer" ], "type": "string", "description": "apps = full detail for package ids you name. search = Play Store keyword search. developer = every app by one developer. There is no top-charts mode: Google Play renders those collections client-side and serves zero package ids in the HTML.", "default": "apps" }, "packageIds": { "title": "Package IDs or app URLs", "type": "array", "description": "For mode='apps'. A package id like `com.whatsapp` or a full play.google.com/store/apps/details URL. A package that does not exist is an honest 404.", "items": { "type": "string" } }, "searchTerm": { "title": "Search term", "type": "string", "description": "For mode='search'. One page yields 30 apps. A term that matches nothing returns an honest zero, not a widened list." }, "developerId": { "title": "Developer ID", "type": "string", "description": "For mode='developer'. The numeric id from a /store/apps/dev?id=... URL. An unknown id is an honest 404." }, "country": { "title": "Storefront country", "type": "string", "description": "Two-letter code. THIS CHANGES PRICES: the same paid app is 6.99 USD in US, 6.99 GBP in GB and 19,000 IDR in ID. An unrecognised code is REFUSED here, because Google Play does not reject one — it silently prices the app in the currency of whatever IP the request came from, so the same run would give different prices depending on where it executed. Note it is INERT on search: US, GB and ID returned the identical 30 packages in identical order.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Two-letter code used for descriptions and category names.", "default": "en" }, "fetchAppDetails": { "title": "Fetch each app's own page", "type": "boolean", "description": "search/developer only — apps mode always fetches it. Off returns just the ordered package list at one request total; on adds ratings, install counts, price, developer and description at one request per app.", "default": false }, "maxResults": { "title": "Max apps", "minimum": 0, "type": "integer", "description": "Set 0 for unlimited. A search page holds 30 apps and exposes no next-page control in the served HTML.", "default": 30 }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 12, "type": "integer", "description": "App-detail fetches in flight at once.", "default": 4 }, "minRequestInterval": { "title": "Min seconds between request starts", "minimum": 0, "maximum": 30, "type": "integer", "description": "Politeness pacing shared across all workers. 0 uses the built-in default. Reconnaissance saw zero interstitials across 32 requests; raise this if any appear.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "No WAF was found on this host at all — 32 of 32 probe requests were clean without a proxy. Residential still defaults on for cloud runs for a data-quality reason rather than an access one: an unrecognised country is priced from the exit IP.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }