{ "openapi": "3.0.1", "info": { "title": "Google Play Scraper", "description": "Extract complete Google Play app data, including descriptions, ratings, reviews, installs, screenshots, versions, and developer info. Ideal for market research, competitor analysis, ASO, and dataset creation. Fast, reliable, and perfect for automated app intelligence.", "version": "0.2", "x-build-id": "T3IucdVqpRvN51Rr2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~google-play-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-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/scraper-engine~google-play-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-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/scraper-engine~google-play-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-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", "required": [ "action" ], "properties": { "action": { "title": "🎯 Select action to perform", "enum": [ "scrapeAppSearch", "scrapeAppUrls", "scrapeSimilarApps", "scrapeReviews" ], "type": "string", "description": "Decides what is scraped. Only the matching section below is used. 🧭", "default": "scrapeAppSearch" }, "scrapeAppSearch.keywords": { "title": "πŸ” Search keywords", "type": "array", "description": "Keywords to search the Google Play Store for. One keyword per line - bulk supported. 🧠", "items": { "type": "string" } }, "scrapeAppSearch.country": { "title": "🌍 Search storefront country", "enum": [ "us", "ar", "au", "at", "bd", "be", "bo", "br", "bg", "ca", "cl", "cn", "co", "cr", "hr", "cy", "cz", "dk", "do", "ec", "eg", "ee", "fi", "fr", "de", "gh", "gr", "gt", "hk", "hu", "is", "in", "id", "ie", "il", "it", "jp", "jo", "kz", "ke", "kw", "lv", "lb", "lt", "lu", "my", "mt", "mx", "ma", "nl", "nz", "ng", "no", "om", "pk", "pa", "py", "pe", "ph", "pl", "pt", "qa", "ro", "ru", "sa", "rs", "sg", "sk", "si", "za", "kr", "es", "lk", "se", "ch", "tw", "tz", "th", "tn", "tr", "ua", "ae", "gb", "uy", "ve", "vn" ], "type": "string", "description": "Google Play storefront the keyword search runs against. πŸ—ΊοΈ", "default": "us" }, "scrapeAppUrls.urls": { "title": "πŸ”— App URLs or package names", "type": "array", "description": "One or more Google Play app URLs or raw package names (for example com.example.app). Bulk supported. πŸ“₯", "items": { "type": "string" } }, "scrapeSimilarApps.urls": { "title": "πŸ”— Source app URLs or package names", "type": "array", "description": "Similar / recommended apps are collected from each source app you list here. Bulk supported. πŸ“₯", "items": { "type": "string" } }, "scrapeReviews.appId": { "title": "πŸ†” App ID(s)", "type": "string", "description": "The Google Play package name (the ?id= value in the app URL), for example com.example.app. A full app URL works too. Enter several on separate lines to collect reviews for more than one app in a single run. πŸ“²" }, "scrapeReviews.country": { "title": "🌍 Reviews storefront country", "enum": [ "us", "ar", "au", "at", "bd", "be", "bo", "br", "bg", "ca", "cl", "cn", "co", "cr", "hr", "cy", "cz", "dk", "do", "ec", "eg", "ee", "fi", "fr", "de", "gh", "gr", "gt", "hk", "hu", "is", "in", "id", "ie", "il", "it", "jp", "jo", "kz", "ke", "kw", "lv", "lb", "lt", "lu", "my", "mt", "mx", "ma", "nl", "nz", "ng", "no", "om", "pk", "pa", "py", "pe", "ph", "pl", "pt", "qa", "ro", "ru", "sa", "rs", "sg", "sk", "si", "za", "kr", "es", "lk", "se", "ch", "tw", "tz", "th", "tn", "tr", "ua", "ae", "gb", "uy", "ve", "vn" ], "type": "string", "description": "Google Play storefront the reviews are read from. πŸ—ΊοΈ", "default": "us" }, "cursor": { "title": "β†ͺ️ Resume reviews from cursor", "type": "string", "description": "Continue a review collection where a previous run stopped. Copy the value stored under the **lastCursor** key in that run's key-value store. πŸ”", "default": "" }, "country": { "title": "🌍 Storefront country (app URLs & similar apps)", "enum": [ "us", "ar", "au", "at", "bd", "be", "bo", "br", "bg", "ca", "cl", "cn", "co", "cr", "hr", "cy", "cz", "dk", "do", "ec", "eg", "ee", "fi", "fr", "de", "gh", "gr", "gt", "hk", "hu", "is", "in", "id", "ie", "il", "it", "jp", "jo", "kz", "ke", "kw", "lv", "lb", "lt", "lu", "my", "mt", "mx", "ma", "nl", "nz", "ng", "no", "om", "pk", "pa", "py", "pe", "ph", "pl", "pt", "qa", "ro", "ru", "sa", "rs", "sg", "sk", "si", "za", "kr", "es", "lk", "se", "ch", "tw", "tz", "th", "tn", "tr", "ua", "ae", "gb", "uy", "ve", "vn" ], "type": "string", "description": "Google Play storefront used by the **πŸ“¦ Scrape app URLs** and **🧩 Scrape similar apps** actions. Prices, availability and ratings are storefront-specific. πŸ—ΊοΈ", "default": "us" }, "language": { "title": "πŸ—£οΈ Listing language", "enum": [ "en", "ar", "bn", "de", "es", "fa", "fil", "fr", "hi", "id", "it", "ja", "ko", "ms", "nl", "pl", "pt", "pt-BR", "ru", "sv", "th", "tr", "uk", "vi", "zh-CN", "zh-TW" ], "type": "string", "description": "Language of the returned listing text - title, summary, description and What's new. Applies to every action. 🈯", "default": "en" }, "count": { "title": "πŸ”’ Maximum records", "minimum": 0, "type": "integer", "description": "Upper limit on how many records the run stores. Leave empty or 0 to collect everything available. ♾️" }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy", "type": "object", "description": "Apify Proxy settings used by the actor's network routes.", "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 } } }, "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 } } } } } } } } } }