{ "openapi": "3.0.1", "info": { "title": "Google Play Scraper — App Details, Ratings & Installs", "description": "Scrape Google Play app pages by package name, developer, category or similar apps: title, developer, category, rating with 1–5 star counts, installs, price, ads, in-app purchases, last update, version, Data safety summary, permissions, screenshots. Any country and language. No login.", "version": "0.1", "x-build-id": "o1PaURdgTQJrcsSsw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~google-play-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-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/yugenox~google-play-scraper/runs": { "post": { "operationId": "runs-sync-yugenox-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/yugenox~google-play-scraper/run-sync": { "post": { "operationId": "run-sync-yugenox-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", "type": "array", "description": "Package names such as \"com.spotify.music\" (the id= part of a Google Play link), or Google Play app links. One app page is read per app.", "items": { "type": "string" } }, "developers": { "title": "🏢 Developers", "type": "array", "description": "Developer names exactly as Google Play shows them (\"Spotify AB\"), numeric developer ids, or developer page links. Scrapes the apps on that developer's Google Play page (Google Play lists roughly the first 10–20 apps there).", "items": { "type": "string" } }, "categories": { "title": "🗂️ Categories", "type": "array", "description": "Apps from Google Play's category pages: every list on the page first, then each list's \"see more\" page while you still need apps. \"All apps\" / \"All games\" use the apps and games home pages.", "items": { "type": "string", "enum": [ "APPLICATION", "GAME", "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", "WATCH_FACE", "WEATHER", "FAMILY", "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" ], "enumTitles": [ "All apps (home page)", "All games (home page)", "Art & Design", "Auto & Vehicles", "Beauty", "Books & Reference", "Business", "Comics", "Communication", "Dating", "Education", "Entertainment", "Events", "Finance", "Food & Drink", "Health & Fitness", "House & Home", "Libraries & Demo", "Lifestyle", "Maps & Navigation", "Medical", "Music & Audio", "News & Magazines", "Parenting", "Personalization", "Photography", "Productivity", "Shopping", "Social", "Sports", "Tools", "Travel & Local", "Video Players & Editors", "Watch faces", "Weather", "Kids", "Action games", "Adventure games", "Arcade games", "Board games", "Card games", "Casino games", "Casual games", "Educational games", "Music games", "Puzzle games", "Racing games", "Role Playing games", "Simulation games", "Sports games", "Strategy games", "Trivia games", "Word games" ] } }, "startUrls": { "title": "🔗 Other Google Play URLs", "type": "array", "description": "Any Google Play page with apps: app pages, developer pages, category pages, \"see more\" list pages (/store/apps/collection/cluster?…), the apps or games home page. Search pages (/store/search) are skipped: Google Play's robots.txt does not allow crawling them.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max apps", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of apps for the whole run. Developer and category pages share what is left after your app IDs. 0 = everything (up to 10,000).", "default": 100 }, "country": { "title": "🌍 Country", "type": "string", "description": "Two-letter country code of the Google Play store to read (gl), e.g. US, GB, DE, IN, BR. It sets the currency and price, the ratings shown and availability.", "default": "US" }, "language": { "title": "🗣️ Language", "type": "string", "description": "Language of the store page (hl), e.g. en, de, fr, es, pt_BR, ja. Titles and descriptions come in this language when the developer provides it.", "default": "en" }, "similarApps": { "title": "Similar apps per app", "minimum": 0, "maximum": 50, "type": "integer", "description": "Also scrape up to this many apps from each app's \"Similar apps\" list (one level deep). 0 = off. Up to 6 come from the app page itself; more opens the full \"Similar apps\" list (up to about 50). Good for competitor research.", "default": 0 }, "includeMoreByDeveloper": { "title": "Include more apps by the same developer", "type": "boolean", "description": "Also scrape the apps in each app's \"More by \" list.", "default": false }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many Google Play pages are read at the same time.", "default": 3 }, "residentialFallback": { "title": "Fall back to residential proxies", "type": "boolean", "description": "When Google Play keeps refusing datacenter IPs, carry on through residential proxies (if your Apify account has them). Each app read through residential proxies costs an extra fee (the \"App via residential proxy\" event on the Pricing tab); apps read on datacenter never do. Turn off to stay on datacenter only — the run then stops with what it has if Google Play keeps refusing.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (datacenter) is the default and comes with every Apify plan. Picking RESIDENTIAL here makes every app carry the residential fee (see Pricing). Your own proxy URLs never do.", "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 } } } } } } } } } }