{ "openapi": "3.0.1", "info": { "title": "Google Play Store Scraper", "description": "Scrape Google Play Store apps, reviews, permissions, and Data Safety disclosures from keywords, package IDs, app URLs, category pages, or developer pages. Export app metadata, ratings, prices, developers, review text, replies, source URLs, permissions, privacy disclosures, ranks, and locale fields.", "version": "0.2", "x-build-id": "wbs3Nd6J5Ta84lcQr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~google-play-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-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/maximedupre~google-play-store-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-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/maximedupre~google-play-store-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-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", "required": [ "mode", "targets", "maxAppsPerTarget", "maxReviewsPerApp", "reviewSort", "country", "language", "includeDetails" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "details", "reviews", "category", "developer", "permissions", "dataSafety" ], "type": "string", "description": "Choose the Google Play surface to scrape: app search, app details, app reviews, category pages, developer pages, app permissions, or Data Safety disclosures.", "default": "search" }, "targets": { "title": "Google Play targets", "minItems": 1, "maxItems": 100, "type": "array", "description": "Add one target per line. Use keywords for search mode, package IDs or app URLs for details, reviews, permissions, and Data Safety, category IDs/URLs for category mode, and developer names/IDs/URLs for developer mode.", "items": { "type": "string", "minLength": 1 } }, "maxAppsPerTarget": { "title": "Apps per target", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum app items to save for each search, category, developer, or details target.", "default": 14 }, "maxReviewsPerApp": { "title": "Reviews per app", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum public review items to save for each app in reviews mode.", "default": 100 }, "reviewSort": { "title": "Review order", "enum": [ "newest", "rating", "helpfulness" ], "type": "string", "description": "How Google Play should order reviews in reviews mode.", "default": "newest" }, "reviewScore": { "title": "Review star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only save reviews with this exact star rating. Leave empty to save all ratings." }, "country": { "title": "Country", "enum": [ "US", "CA", "GB", "AU", "DE", "FR", "ES", "IT", "NL", "BR", "MX", "JP", "IN", "PT" ], "type": "string", "description": "Google Play country code. App listings, prices, availability, and reviews can vary by market.", "default": "US" }, "language": { "title": "Language", "enum": [ "en", "de", "fr", "es", "it", "nl", "pt", "ja" ], "type": "string", "description": "Google Play language code for localized app pages and reviews.", "default": "en" }, "includeDetails": { "title": "Full app details", "type": "boolean", "description": "Open each discovered app page to include title, description, ratings, developer, price, icon, screenshot URLs, and similar apps. Turn off for faster discovery-only runs.", "default": 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 } } } } } } } } } }