{ "openapi": "3.0.1", "info": { "title": "Google Play Store Scraper (Apps, Charts, Similar, Reviews)", "description": "Google Play app details, search results, developer catalogs, similar apps and top charts as clean JSON for any country: rating, installs, price, in-app purchases, content rating, version, last update, developer contact, screenshots and optional recent reviews. One record per app.", "version": "1.1", "x-build-id": "t546om3sCiVNoNbUA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mdcurt~google-play-app-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mdcurt-google-play-app-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/mdcurt~google-play-app-scraper/runs": { "post": { "operationId": "runs-sync-mdcurt-google-play-app-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/mdcurt~google-play-app-scraper/run-sync": { "post": { "operationId": "run-sync-mdcurt-google-play-app-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": [ "queries" ], "properties": { "queries": { "title": "Queries (app IDs, search terms, developers, charts or Play URLs)", "minItems": 1, "uniqueItems": true, "type": "array", "description": "What to look up - one record per app. Each entry is auto-detected: an Android package name (`com.spotify.music`) → full app details; a search term (`meditation`) → the first ~25-30 search results; `dev:Spotify AB` or a numeric developer id → that publisher's catalog; `similar:com.spotify.music` → Google's similar-apps cluster for that app; `chart:TOP_FREE`, `chart:TOP_PAID:GAME`, `chart:GROSSING:FINANCE` → top charts (collection TOP_FREE / TOP_PAID / GROSSING, optional category id); any play.google.com app, search, developer or cluster URL also works. A single app id returns in about a second.", "default": [ "meditation" ], "items": { "type": "string" } }, "locales": { "title": "Store fronts (language-COUNTRY)", "minItems": 1, "uniqueItems": true, "type": "array", "description": "One or more store fronts as `en-US`, `de-DE`, `pt-BR`, `ja-JP`, `en-IN`… Every query runs once per store front and each (app, country) pair is its own record, so you can compare prices, availability, ratings and rankings across countries in one run.", "default": [ "en-US" ], "items": { "type": "string" } }, "maxItems": { "title": "Max app records", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many app records in total across all queries (each record is one charged dataset item).", "default": 50 }, "fetchDetails": { "title": "Fetch full details for search / developer results", "type": "boolean", "description": "On: every app found by a search or developer query is opened for the full record (installs, ratings count, histogram, IAP, content rating, version, update date, developer contact, screenshots). Off: search and developer queries return the lighter listing card (title, developer, rating, price, icon) with no extra requests - fastest and cheapest for shortlists. App-id queries always return full details.", "default": true }, "reviewsPerApp": { "title": "Recent reviews per app (0-200)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Embed up to this many most-recent user reviews in each app record (author, 1-5 score, text snippet of at most 300 characters, date, thumbs up, app version, developer reply). 0 = no reviews. Reviews are part of the app record and are not charged separately.", "default": 0 }, "knownIds": { "title": "Known app IDs to skip (incremental mode)", "type": "array", "description": "App IDs you already have. Apps in this list are skipped before any detail request is made, so a scheduled run of a search or developer query only pays for apps that are new since last time.", "default": [], "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google Play serves datacenter IPs fine at polite rates, so Apify datacenter proxies (the default) are enough; switch to residential only if your runs report blocked pages.", "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 } } } } } } } } } }