{ "openapi": "3.0.1", "info": { "title": "Google Play Scraper: Apps, Reviews & Charts", "description": "Scrape Google Play apps, 63-field details, reviews, top charts, developer portfolios, similar apps, Data Safety, permissions, and search suggestions. Export clean JSON for any country or language—no login, API key, browser, or proxy setup.", "version": "0.0", "x-build-id": "dQdMDXw0gIxGWvnae" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapingmonkey~google-play-scraper-apps-reviews-charts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapingmonkey-google-play-scraper-apps-reviews-charts", "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/scrapingmonkey~google-play-scraper-apps-reviews-charts/runs": { "post": { "operationId": "runs-sync-scrapingmonkey-google-play-scraper-apps-reviews-charts", "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/scrapingmonkey~google-play-scraper-apps-reviews-charts/run-sync": { "post": { "operationId": "run-sync-scrapingmonkey-google-play-scraper-apps-reviews-charts", "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" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "details", "reviews", "charts", "developer", "similar", "suggest" ], "type": "string", "description": "Choose one of seven Google Play scraping modes.", "default": "search" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search for. Required in search and suggest modes.", "items": { "type": "string" }, "default": [ "fitness tracker" ] }, "appIds": { "title": "App IDs", "type": "array", "description": "Google Play package IDs. Required in details, reviews, and similar modes.", "items": { "type": "string" }, "default": [] }, "developerIds": { "title": "Developer IDs", "type": "array", "description": "Numeric Google Play developer IDs or developer names. Required in developer mode.", "items": { "type": "string" }, "default": [] }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum results per search term, app, developer, or chart.", "default": 50 }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of independent search terms, app IDs, or developer IDs processed concurrently. Pagination for one target remains sequential.", "default": 5 }, "country": { "title": "Country", "minLength": 2, "maxLength": 2, "type": "string", "description": "ISO 3166-1 alpha-2 country code.", "default": "us" }, "language": { "title": "Language", "minLength": 2, "maxLength": 2, "type": "string", "description": "ISO 639-1 language code.", "default": "en" }, "reviewSort": { "title": "Review sort", "enum": [ "newest", "rating", "relevant" ], "type": "string", "description": "Order used in reviews mode.", "default": "newest" }, "reviewScore": { "title": "Review score", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional star rating filter from 1 to 5. Leave empty to return all ratings." }, "chartCollection": { "title": "Chart collection", "enum": [ "topFree", "topPaid", "topGrossing" ], "type": "string", "description": "Ranking to collect in charts mode.", "default": "topFree" }, "category": { "title": "Google Play category", "type": "string", "description": "Google Play category ID for charts, for example APPLICATION, GAME, BUSINESS, or PRODUCTIVITY.", "default": "APPLICATION" }, "includeDataSafety": { "title": "Include Data Safety", "type": "boolean", "description": "Fetch complete collected/shared data and security practices in details mode.", "default": true }, "includePermissions": { "title": "Include permissions", "type": "boolean", "description": "Fetch the complete public Android permissions list in details mode.", "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 } } } } } } } } } }