{ "openapi": "3.0.1", "info": { "title": "Google Play Store Review Scraper", "description": "Reading Google Play reviews one by one hides why users leave. Scrape reviews for any Android app: stars, text, date, app version, helpful votes and developer replies, with star, date, language and device filters plus topics like crashes and ads.", "version": "1.0", "x-build-id": "XdVEv0Z0N90VYnNnH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawl_craft~google-playstore-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawl_craft-google-playstore-review-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/crawl_craft~google-playstore-review-scraper/runs": { "post": { "operationId": "runs-sync-crawl_craft-google-playstore-review-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/crawl_craft~google-playstore-review-scraper/run-sync": { "post": { "operationId": "run-sync-crawl_craft-google-playstore-review-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": [ "urls" ], "properties": { "urls": { "title": "📲 Apps to scrape", "minItems": 1, "type": "array", "description": "Google Play app links or package names, one per line (for example https://play.google.com/store/apps/details?id=com.whatsapp or com.spotify.music). Duplicates are removed.", "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "🔢 Max reviews per app", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Reviews to collect for each app and language. Use 0 for all available reviews (big apps have millions).", "default": 10 }, "reviewsSort": { "title": "🔃 Sort reviews by", "enum": [ "newest", "most_relevant", "rating" ], "type": "string", "description": "Newest first, most relevant first (Google's helpfulness ranking) or by rating. A date limit always uses newest first.", "default": "newest" }, "stars": { "title": "⭐ Star ratings", "type": "array", "description": "Keep only these star ratings, for example 1 and 2 for complaints. Leave empty for all stars.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] }, "default": [] }, "since": { "title": "🗓️ Only reviews newer than", "type": "string", "description": "Pick a date: only reviews posted on or after it are kept. Leave empty for no date limit. Google publishes reviews with about one day delay." }, "languages": { "title": "🌐 Review languages", "type": "array", "description": "Google Play serves a different set of reviews per language. Each language you pick is collected separately.", "items": { "type": "string", "enum": [ "en", "es", "es-419", "de", "fr", "pt-BR", "pt-PT", "it", "nl", "ru", "uk", "pl", "cs", "sk", "hu", "ro", "bg", "el", "tr", "sv", "da", "no", "fi", "hr", "sr", "sl", "lt", "lv", "et", "ar", "iw", "fa", "hi", "bn", "ta", "te", "mr", "gu", "kn", "ml", "pa", "ur", "id", "ms", "th", "vi", "fil", "ja", "ko", "zh-CN", "zh-TW", "zh-HK", "sw", "af", "am", "ne", "si", "km", "my", "ka", "hy", "az", "kk", "uz", "is", "ca" ], "enumTitles": [ "English (en)", "Spanish (es)", "Spanish (Latin America) (es-419)", "German (de)", "French (fr)", "Portuguese (Brazil) (pt-BR)", "Portuguese (Portugal) (pt-PT)", "Italian (it)", "Dutch (nl)", "Russian (ru)", "Ukrainian (uk)", "Polish (pl)", "Czech (cs)", "Slovak (sk)", "Hungarian (hu)", "Romanian (ro)", "Bulgarian (bg)", "Greek (el)", "Turkish (tr)", "Swedish (sv)", "Danish (da)", "Norwegian (no)", "Finnish (fi)", "Croatian (hr)", "Serbian (sr)", "Slovenian (sl)", "Lithuanian (lt)", "Latvian (lv)", "Estonian (et)", "Arabic (ar)", "Hebrew (iw)", "Persian (fa)", "Hindi (hi)", "Bengali (bn)", "Tamil (ta)", "Telugu (te)", "Marathi (mr)", "Gujarati (gu)", "Kannada (kn)", "Malayalam (ml)", "Punjabi (pa)", "Urdu (ur)", "Indonesian (id)", "Malay (ms)", "Thai (th)", "Vietnamese (vi)", "Filipino (fil)", "Japanese (ja)", "Korean (ko)", "Chinese (Simplified) (zh-CN)", "Chinese (Traditional) (zh-TW)", "Chinese (Hong Kong) (zh-HK)", "Swahili (sw)", "Afrikaans (af)", "Amharic (am)", "Nepali (ne)", "Sinhala (si)", "Khmer (km)", "Burmese (my)", "Georgian (ka)", "Armenian (hy)", "Azerbaijani (az)", "Kazakh (kk)", "Uzbek (uz)", "Icelandic (is)", "Catalan (ca)" ] }, "default": [ "en" ] }, "country": { "title": "📍 Store country", "enum": [ "us", "gb", "ca", "au", "nz", "ie", "in", "pk", "bd", "lk", "np", "de", "at", "ch", "fr", "be", "nl", "lu", "es", "pt", "it", "gr", "se", "no", "dk", "fi", "is", "pl", "cz", "sk", "hu", "ro", "bg", "hr", "rs", "si", "lt", "lv", "ee", "ua", "ru", "by", "tr", "il", "ae", "sa", "qa", "kw", "om", "bh", "jo", "lb", "iq", "eg", "ma", "dz", "tn", "ng", "gh", "ke", "tz", "ug", "za", "et", "br", "mx", "ar", "cl", "co", "pe", "ve", "ec", "uy", "py", "bo", "cr", "pa", "do", "gt", "cn", "hk", "tw", "jp", "kr", "sg", "my", "id", "th", "vn", "ph", "kh", "mm", "kz", "uz", "ge", "am", "az" ], "type": "string", "description": "Google Play store country. It changes the most-relevant ranking and the app details.", "default": "us" }, "devices": { "title": "📱 Device types", "type": "array", "description": "Each device type has its own reviews. Choose phone, tablet, chromebook, watch, tv or car.", "items": { "type": "string", "enum": [ "phone", "tablet", "chromebook", "watch", "tv", "car" ], "enumTitles": [ "Phone", "Tablet", "Chromebook", "Watch", "TV", "Car" ] }, "default": [ "phone" ] }, "proxyConfiguration": { "title": "🛡️ Proxy configuration", "type": "object", "description": "Optional. Leave the default if you are unsure. Choose your own proxy setup here if you need one.", "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 } } } } } } } } } }