{ "openapi": "3.0.1", "info": { "title": "Google Play Reviews Scraper - Reviews, Replies & App Data", "description": "Scrape Google Play reviews with star rating, text, likes, app version, date and the developer's reply, plus app details (rating histogram, installs, developer contacts). Many apps and countries per run, star and date filters, new-reviews-only monitoring. $0.10 per 1,000 reviews.", "version": "0.1", "x-build-id": "wQ8IDsG3hmdNoSCp8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alex9080~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alex9080-google-play-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/alex9080~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-alex9080-google-play-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/alex9080~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-alex9080-google-play-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", "properties": { "apps": { "title": "Apps", "type": "array", "description": "Google Play app IDs (com.whatsapp) or app page URLs (https://play.google.com/store/apps/details?id=com.whatsapp). Give apps, searchTerms, or both.", "items": { "type": "string" } }, "searchTerms": { "title": "Or find apps by keyword", "type": "array", "description": "Search Google Play and scrape the top apps for each keyword, e.g. \"budget tracker\".", "items": { "type": "string" } }, "appsPerSearch": { "title": "Apps per keyword", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many top search results to take for each keyword.", "default": 5 }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 0, "type": "integer", "description": "0 = all available reviews.", "default": 200 }, "sort": { "title": "Sort", "enum": [ "newest", "most_relevant", "rating" ], "type": "string", "description": "Newest first is required for the date cut-off and new-only mode to stop early.", "default": "newest" }, "stars": { "title": "Only these star ratings", "type": "array", "description": "Leave empty for all ratings. Example: 1 and 2 for complaints only.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "since": { "title": "Reviews since", "type": "string", "description": "Skip reviews older than this date (YYYY-MM-DD)." }, "onlyNewReviews": { "title": "Only reviews not seen in previous runs", "type": "boolean", "description": "For scheduled monitoring: remembers review IDs between runs (in your own storage) and returns only new ones.", "default": false }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes. Reviews from all of them are merged and de-duplicated.", "items": { "type": "string" } }, "language": { "title": "Review language", "type": "string", "description": "Two-letter language code: Google Play returns reviews written in this language (en, de, fr, es, pt, uk, ...).", "default": "en" }, "includeAppDetails": { "title": "Include app details", "type": "boolean", "description": "One extra row per app: rating, histogram, installs, price, developer email and website, last update.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed normally. Turn on if Google starts rate-limiting large runs.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }