{ "openapi": "3.0.1", "info": { "title": "Play Store Reviews Scraper", "description": "Instantly collect thousands of user reviews from any Android app on the Google Play Store! Scrape full review texts, precise timestamps, likes, and developer responses using deep pagination. Track user issues or monitor competitor app feedback effortlessly.", "version": "1.0", "x-build-id": "B9wPcEG7vqy2hQvBD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/burbn~play-store-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-burbn-play-store-reviews-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/burbn~play-store-reviews-scraper/runs": { "post": { "operationId": "runs-sync-burbn-play-store-reviews-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/burbn~play-store-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-burbn-play-store-reviews-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": [ "app_id" ], "properties": { "app_id": { "title": "📱 App ID", "type": "string", "description": "The unique App ID of the Play Store app you want to scrape (e.g., 'com.snapchat.android', 'com.whatsapp').", "default": "com.instagram.android" }, "limit": { "title": "📦 Reviews per Page", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Number of reviews to fetch per page/request. Range: 1-4000. Larger limits can be faster but may increase timeout risks.", "default": 30 }, "maxPages": { "title": "📑 Maximum Pages", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of pagination requests to make. Set higher for comprehensive review data extraction.", "default": 1 }, "sort_by": { "title": "🔄 Sort By", "enum": [ "MOST_RELEVANT", "NEWEST", "RATING" ], "type": "string", "description": "Order parameter for the reviews. Options: MOST_RELEVANT, NEWEST, RATING.", "default": "NEWEST" }, "rating": { "title": "⭐ Star Rating Filter", "enum": [ "ANY", "ONE_STAR", "TWO_STARS", "THREE_STARS", "FOUR_STARS", "FIVE_STARS" ], "type": "string", "description": "Filter reviews by a specific star rating number to focus on exactly what you need.", "default": "ANY" }, "device": { "title": "📱 Device Filter", "enum": [ "PHONE", "TABLET", "CHROMEBOOK" ], "type": "string", "description": "Filter reviews published by users evaluating the app on a specific device type.", "default": "PHONE" }, "region": { "title": "🌍 Region / Country Code", "type": "string", "description": "ISO 3166-1 alpha-2 country code to localize the requested Play Store results (e.g. US, IN, GB).", "default": "US" }, "language": { "title": "🗣️ Language Code", "type": "string", "description": "ISO 639-1 alpha-2 language code corresponding to user locales (e.g. EN, ES, HI).", "default": "EN" } } }, "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 } } } } } } } } } }