{ "openapi": "3.0.1", "info": { "title": "Google Play Store Scraper [FAST] | Apps & Charts", "description": "Find Google Play apps by keyword, browse Top Free, Paid, or Grossing charts, or fetch details by package ID. Get installs, ratings, screenshots, prices, and publisher contacts via JSON API or Dataset. Pay per delivered app: $0.003/listing or $0.006/detail. Failed results have no result event.", "version": "0.0", "x-build-id": "44RlaGThvFlfphOnB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apizy~google-play-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apizy-google-play-store-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/apizy~google-play-store-scraper/runs": { "post": { "operationId": "runs-sync-apizy-google-play-store-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/apizy~google-play-store-scraper/run-sync": { "post": { "operationId": "run-sync-apizy-google-play-store-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": "Mode", "enum": [ "search", "charts", "details" ], "type": "string", "description": "Choose Search, Top Charts, or Details by app ID/URL.", "default": "search" }, "keyword": { "title": "Keyword (Search)", "type": "string", "description": "One keyword or phrase. Use this or Keywords in Search mode." }, "keywords": { "title": "Keywords (Search)", "minItems": 1, "maxItems": 20, "type": "array", "description": "Up to 20 keywords or phrases. Duplicate apps are saved once, with all keyword/rank contexts retained.", "items": { "type": "string" } }, "chart": { "title": "Chart (Top Charts)", "enum": [ "top-free", "top-paid", "top-grossing" ], "type": "string", "description": "Choose Top Free, Top Paid, or Top Grossing. Combine with Category to browse a niche, such as Top Free RPG games. Some combinations may return no apps.", "default": "top-free" }, "category": { "title": "Category (Top Charts)", "enum": [ "APPLICATION", "GAME", "GAME_ACTION", "GAME_ADVENTURE", "GAME_ARCADE", "GAME_BOARD", "GAME_CARD", "GAME_CASINO", "GAME_CASUAL", "GAME_EDUCATIONAL", "GAME_MUSIC", "GAME_PUZZLE", "GAME_RACING", "GAME_ROLE_PLAYING", "GAME_SIMULATION", "GAME_SPORTS", "GAME_STRATEGY", "GAME_TRIVIA", "GAME_WORD", "ART_AND_DESIGN", "AUTO_AND_VEHICLES", "BEAUTY", "BOOKS_AND_REFERENCE", "BUSINESS", "COMICS", "COMMUNICATION", "DATING", "EDUCATION", "ENTERTAINMENT", "EVENTS", "FINANCE", "FOOD_AND_DRINK", "HEALTH_AND_FITNESS", "HOUSE_AND_HOME", "LIBRARIES_AND_DEMO", "LIFESTYLE", "MAPS_AND_NAVIGATION", "MEDICAL", "MUSIC_AND_AUDIO", "NEWS_AND_MAGAZINES", "PARENTING", "PERSONALIZATION", "PHOTOGRAPHY", "PRODUCTIVITY", "SHOPPING", "SOCIAL", "SPORTS", "TOOLS", "TRAVEL_AND_LOCAL", "VIDEO_PLAYERS", "WEATHER" ], "type": "string", "description": "Choose one of 49 current Google Play app/game categories, or All apps/All games. For RPG charts, choose Games: Role Playing (RPG). Some chart/category combinations may return no apps.", "default": "APPLICATION" }, "app": { "title": "App ID or URL (Details)", "type": "string", "description": "One Android package ID or Google Play app URL. Use this or Apps in Details mode." }, "apps": { "title": "Apps (Details)", "minItems": 1, "maxItems": 100, "type": "array", "description": "Up to 100 package IDs or Google Play URLs. Invalid apps are reported individually.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum results per keyword or chart", "minimum": 1, "maximum": 250, "type": "integer", "description": "Upper limit for each Search keyword or Chart. Google Play may provide fewer apps.", "default": 100 }, "fullDetail": { "title": "Fetch full app details (Search/Charts)", "type": "boolean", "description": "Enrich every found app with description, images, ratings, install badge, price, and publisher fields. Details mode always fetches full details.", "default": false }, "language": { "title": "Store language", "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z]{2})?$", "type": "string", "description": "Google Play language code, such as en, id, or pt-BR. Content is not translated by the Actor.", "default": "en" }, "country": { "title": "Store country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter Google Play country code, such as us or id. Charts and prices depend on country.", "default": "us" } } }, "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 } } } } } } } } } }