{ "openapi": "3.0.1", "info": { "title": "Google Play Reviews Scraper & API - Installs, Rankings, Charts", "description": "Scrape Google Play reviews newest first and as deep as you need, with developer replies, app versions, filters (stars, dates, words, versions) and Slack, Discord or Teams alerts for new reviews, plus installs, data safety, developer email, keyword rankings and top charts.", "version": "0.1", "x-build-id": "RPqIeFiHsUg2NRuJg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/akhil_rajesh~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-akhil_rajesh-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/akhil_rajesh~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-akhil_rajesh-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/akhil_rajesh~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-akhil_rajesh-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 links (play.google.com/store/apps/details?id=com.spotify.music), package names (com.spotify.music) or app names (a name is looked up on Google Play's search and must hold every word you type; the row says which app it matched).", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Google Play countries for app details (price, availability), search rankings and charts. Reviews go by language, not country (see Languages). Empty: United States.", "items": { "type": "string", "enum": [ "ae", "ag", "ai", "al", "am", "ao", "ar", "at", "au", "az", "bb", "be", "bf", "bg", "bh", "bj", "bm", "bn", "bo", "br", "bs", "bt", "bw", "by", "bz", "ca", "cg", "ch", "ci", "cl", "cm", "cn", "co", "cr", "cv", "cy", "cz", "de", "dk", "dm", "do", "dz", "ec", "ee", "eg", "es", "fi", "fj", "fm", "fr", "ga", "gb", "gd", "ge", "gh", "gm", "gr", "gt", "gw", "gy", "hk", "hn", "hr", "hu", "id", "ie", "il", "in", "iq", "is", "it", "jm", "jo", "jp", "ke", "kg", "kh", "kn", "kr", "kw", "ky", "kz", "la", "lb", "lc", "lk", "lr", "lt", "lu", "lv", "ly", "ma", "md", "me", "mg", "mk", "ml", "mm", "mn", "mo", "mr", "ms", "mt", "mu", "mv", "mw", "mx", "my", "mz", "na", "ne", "ng", "ni", "nl", "no", "np", "nr", "nz", "om", "pa", "pe", "pg", "ph", "pk", "pl", "pt", "pw", "py", "qa", "ro", "rs", "ru", "rw", "sa", "sb", "sc", "se", "sg", "si", "sk", "sl", "sn", "sr", "st", "sv", "sz", "tc", "td", "th", "tj", "tm", "tn", "to", "tr", "tt", "tw", "tz", "ua", "ug", "us", "uy", "uz", "vc", "ve", "vg", "vn", "vu", "xk", "ye", "za", "zm", "zw", "af", "ba", "cd" ], "enumTitles": [ "United Arab Emirates", "Antigua and Barbuda", "Anguilla", "Albania", "Armenia", "Angola", "Argentina", "Austria", "Australia", "Azerbaijan", "Barbados", "Belgium", "Burkina Faso", "Bulgaria", "Bahrain", "Benin", "Bermuda", "Brunei", "Bolivia", "Brazil", "Bahamas", "Bhutan", "Botswana", "Belarus", "Belize", "Canada", "Congo", "Switzerland", "Côte d'Ivoire", "Chile", "Cameroon", "China", "Colombia", "Costa Rica", "Cape Verde", "Cyprus", "Czechia", "Germany", "Denmark", "Dominica", "Dominican Republic", "Algeria", "Ecuador", "Estonia", "Egypt", "Spain", "Finland", "Fiji", "Micronesia", "France", "Gabon", "United Kingdom", "Grenada", "Georgia", "Ghana", "Gambia", "Greece", "Guatemala", "Guinea-Bissau", "Guyana", "Hong Kong", "Honduras", "Croatia", "Hungary", "Indonesia", "Ireland", "Israel", "India", "Iraq", "Iceland", "Italy", "Jamaica", "Jordan", "Japan", "Kenya", "Kyrgyzstan", "Cambodia", "Saint Kitts and Nevis", "South Korea", "Kuwait", "Cayman Islands", "Kazakhstan", "Laos", "Lebanon", "Saint Lucia", "Sri Lanka", "Liberia", "Lithuania", "Luxembourg", "Latvia", "Libya", "Morocco", "Moldova", "Montenegro", "Madagascar", "North Macedonia", "Mali", "Myanmar", "Mongolia", "Macao", "Mauritania", "Montserrat", "Malta", "Mauritius", "Maldives", "Malawi", "Mexico", "Malaysia", "Mozambique", "Namibia", "Niger", "Nigeria", "Nicaragua", "Netherlands", "Norway", "Nepal", "Nauru", "New Zealand", "Oman", "Panama", "Peru", "Papua New Guinea", "Philippines", "Pakistan", "Poland", "Portugal", "Palau", "Paraguay", "Qatar", "Romania", "Serbia", "Russia", "Rwanda", "Saudi Arabia", "Solomon Islands", "Seychelles", "Sweden", "Singapore", "Slovenia", "Slovakia", "Sierra Leone", "Senegal", "Suriname", "São Tomé and Príncipe", "El Salvador", "Eswatini", "Turks and Caicos Islands", "Chad", "Thailand", "Tajikistan", "Turkmenistan", "Tunisia", "Tonga", "Türkiye", "Trinidad and Tobago", "Taiwan", "Tanzania", "Ukraine", "Uganda", "United States", "Uruguay", "Uzbekistan", "Saint Vincent and the Grenadines", "Venezuela", "British Virgin Islands", "Vietnam", "Vanuatu", "Kosovo", "Yemen", "South Africa", "Zambia", "Zimbabwe", "Afghanistan", "Bosnia and Herzegovina", "Congo (Democratic Republic)" ] } }, "languages": { "title": "Languages", "type": "array", "description": "Review languages: Google Play groups reviews by language, so each app's reviews are read in each language picked (Max reviews per app applies to each). The first language is also used for app details and search. Empty: English. Codes such as pt-PT work too.", "items": { "type": "string", "enumSuggestedValues": [ "en", "es", "pt", "pt-BR", "fr", "de", "it", "nl", "pl", "ru", "uk", "tr", "ar", "he", "fa", "hi", "bn", "ur", "ta", "te", "mr", "ml", "kn", "gu", "id", "ms", "fil", "th", "vi", "ja", "ko", "zh-CN", "zh-TW", "sv", "da", "no", "fi", "cs", "sk", "hu", "ro", "el", "bg", "hr", "sr", "sl", "lt", "lv", "et", "sw", "af" ], "enumTitles": [ "English", "Spanish", "Portuguese", "Portuguese (Brazil)", "French", "German", "Italian", "Dutch", "Polish", "Russian", "Ukrainian", "Turkish", "Arabic", "Hebrew", "Persian", "Hindi", "Bengali", "Urdu", "Tamil", "Telugu", "Marathi", "Malayalam", "Kannada", "Gujarati", "Indonesian", "Malay", "Filipino", "Thai", "Vietnamese", "Japanese", "Korean", "Chinese (Simplified)", "Chinese (Traditional)", "Swedish", "Danish", "Norwegian", "Finnish", "Czech", "Slovak", "Hungarian", "Romanian", "Greek", "Bulgarian", "Croatian", "Serbian", "Slovenian", "Lithuanian", "Latvian", "Estonian", "Swahili", "Afrikaans" ] } }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Read each app's reviews.", "default": true }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Reviews to read per app and language, after the filters (100 a page: 10,000 reviews take about a minute). 0: no reviews.", "default": 100 }, "reviewSort": { "title": "Order", "enum": [ "newest", "mostRelevant" ], "type": "string", "description": "Newest first, or the store's own ranking (most relevant). Reviews since and Only new reviews stop early only with newest first.", "default": "newest" }, "starRatings": { "title": "Star ratings", "type": "array", "description": "Only reviews with these stars, asked from Google Play directly: with several picked, Max reviews per app is shared evenly between them. Empty: all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "reviewsSince": { "title": "Reviews since", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Only reviews written on or after this date (UTC), or within this period (7 days, 3 months). With newest first, reading stops at the first older review." }, "reviewContains": { "title": "Reviews that mention", "type": "array", "description": "Only reviews whose text mentions any of these words or phrases (crash, refund, dark mode), in any case and with or without accents. A word also matches the longer words it begins (crash: crashes, crashing). Each review lists the ones it matched (matchedTerms). Empty: every review. With this filter or the ones below, a run reads reviews until Max reviews per app match, or at most 10 times that number (at least 2,000) per app and language: only the reviews returned are charged.", "items": { "type": "string" } }, "developerReply": { "title": "Developer reply", "enum": [ "withReply", "withoutReply" ], "type": "string", "description": "Only reviews the developer replied to, or only those without a reply (to find the ones still waiting). Empty: both." }, "minReviewLength": { "title": "Minimum review length", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only reviews whose text has at least this many characters: 100 leaves out 'great app' and keeps reviews that explain. Empty or 0: any length." }, "minThumbsUp": { "title": "Minimum helpful votes", "minimum": 0, "type": "integer", "description": "Only reviews at least this many people marked helpful. Empty or 0: any." }, "appVersions": { "title": "App versions", "type": "array", "description": "Only reviews written for these app versions: 8.9 matches 8.9 and every 8.9.x (8.9.12.345), not 8.90. Reviews that name no version are left out. Empty: every version.", "items": { "type": "string" } }, "onlyNewReviews": { "title": "Only new reviews", "type": "boolean", "description": "Return only reviews earlier runs with the same History name didn't return, and stop reading where those begin (newest first). For a daily schedule: each run delivers, and charges for, the new reviews only. The first run returns the newest up to Max reviews per app.", "default": false }, "includeReviewSummary": { "title": "Include a review summary", "type": "boolean", "description": "One row per app (and language) with what its reviews said: average stars, share of 1-2 star reviews, developer reply rate, reviews per day, and the words most 1-2 star and 4-5 star reviews use.", "default": true }, "alertWebhookUrl": { "title": "Alert webhook URL", "type": "string", "description": "A Slack incoming webhook (https://hooks.slack.com/services/...), a Discord channel webhook (https://discord.com/api/webhooks/...), a Microsoft Teams Workflows webhook, or any HTTPS URL that takes JSON (Zapier, Make, n8n, your server). Setting it turns on Only new reviews. Stored encrypted, and never shown in the log or the output." }, "alertStars": { "title": "Alert on stars", "type": "array", "description": "Which new reviews to post (up to 50 a run, newest first; the rest are counted). Empty: 1 and 2 stars. Every new review is returned in the dataset either way.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "includeAppDetails": { "title": "Include app details", "type": "boolean", "description": "One row per app and country: installs (with Google Play's exact count), ratings with their histogram, price, in-app purchases, data safety, developer email, website and address.", "default": true }, "keywords": { "title": "Keywords", "type": "array", "description": "Search terms (budget app, photo editor). One ranking per keyword and country.", "items": { "type": "string" } }, "rankPositions": { "title": "Positions per keyword", "minimum": 1, "maximum": 50, "type": "integer", "description": "Ranks to read per keyword. Google Play's search lists about 20-30 apps per keyword.", "default": 25 }, "charts": { "title": "Charts", "type": "array", "description": "Charts to read, in each country.", "items": { "type": "string", "enum": [ "top-free", "top-paid", "top-grossing" ], "enumTitles": [ "Top free", "Top paid", "Top grossing" ] } }, "chartCategories": { "title": "Chart categories", "type": "array", "description": "Categories of each chart. Empty: all apps. (Games (all) is every game; Family the family section.)", "items": { "type": "string", "enum": [ "APPLICATION", "GAME", "FAMILY", "ANDROID_WEAR", "ART_AND_DESIGN", "AUTO_AND_VEHICLES", "BEAUTY", "BOOKS_AND_REFERENCE", "BUSINESS", "COMICS", "COMMUNICATION", "DATING", "EDUCATION", "ENTERTAINMENT", "EVENTS", "FINANCE", "FOOD_AND_DRINK", "HEALTH_AND_FITNESS", "HOUSE_AND_HOME", "LIBRARIES_AND_DEMO", "LIFESTYLE", "MAPS_AND_NAVIGATION", "MEDICAL", "MUSIC_AND_AUDIO", "NEWS_AND_MAGAZINES", "PARENTING", "PERSONALIZATION", "PHOTOGRAPHY", "PRODUCTIVITY", "SHOPPING", "SOCIAL", "SPORTS", "TOOLS", "TRAVEL_AND_LOCAL", "VIDEO_PLAYERS", "WATCH_FACE", "WEATHER", "GAME_ACTION", "GAME_ADVENTURE", "GAME_ARCADE", "GAME_BOARD", "GAME_CARD", "GAME_CASINO", "GAME_CASUAL", "GAME_EDUCATIONAL", "GAME_MUSIC", "GAME_PUZZLE", "GAME_RACING", "GAME_ROLE_PLAYING", "GAME_SIMULATION", "GAME_SPORTS", "GAME_STRATEGY", "GAME_TRIVIA", "GAME_WORD" ], "enumTitles": [ "All apps", "Games (all)", "Family", "Android Wear", "Art & Design", "Auto & Vehicles", "Beauty", "Books & Reference", "Business", "Comics", "Communication", "Dating", "Education", "Entertainment", "Events", "Finance", "Food & Drink", "Health & Fitness", "House & Home", "Libraries & Demo", "Lifestyle", "Maps & Navigation", "Medical", "Music & Audio", "News & Magazines", "Parenting", "Personalization", "Photography", "Productivity", "Shopping", "Social", "Sports", "Tools", "Travel & Local", "Video Players", "Watch Face", "Weather", "Games: Action", "Games: Adventure", "Games: Arcade", "Games: Board", "Games: Card", "Games: Casino", "Games: Casual", "Games: Educational", "Games: Music", "Games: Puzzle", "Games: Racing", "Games: Role Playing", "Games: Simulation", "Games: Sports", "Games: Strategy", "Games: Trivia", "Games: Word" ] } }, "chartPositions": { "title": "Positions per chart", "minimum": 1, "maximum": 200, "type": "integer", "description": "Ranks to read per chart (up to 200).", "default": 100 }, "compareWithLastRun": { "title": "Compare rankings and charts with the last run", "type": "boolean", "description": "Add each app's previous rank and move, and mark new apps. The first run sets the baseline.", "default": true }, "includeDroppedOut": { "title": "Include apps that dropped out", "type": "boolean", "description": "Add a row for each app in the last run's ranking or chart that isn't in this one (on top of the positions asked for).", "default": true }, "historyName": { "title": "History name", "type": "string", "description": "Name of the key-value store that keeps the tracking history (a-z, 0-9 and hyphens). Empty: google-play-reviews-history. Use a new name to start over; under limited permissions the Actor can only open stores it created itself." }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Google Play needs no proxy. Apify's datacenter proxy or your own proxies can be used; residential proxies are refused (billed per GB on top of the result price)." } } }, "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 } } } } } } } } } }