{ "openapi": "3.0.1", "info": { "title": "App Store Reviews Scraper + Google Play Reviews (All Countries)", "description": "Mobile app reviews: App Store reviews API and Google Play reviews API in 175 countries — iOS reviews API and Android reviews (Play Store reviews) with rating, text, version, date, developer reply, free summary, top charts and ASO keyword rankings. Alerts on new negative app reviews.", "version": "0.1", "x-build-id": "560RgMtsPNgfehnWb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/euroscrape~app-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-euroscrape-app-reviews", "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/euroscrape~app-reviews/runs": { "post": { "operationId": "runs-sync-euroscrape-app-reviews", "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/euroscrape~app-reviews/run-sync": { "post": { "operationId": "run-sync-euroscrape-app-reviews", "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 (URLs or IDs)", "type": "array", "description": "App Store URLs or IDs (e.g. https://apps.apple.com/us/app/instagram/id389801252 or id389801252) and Google Play URLs or package names (e.g. com.spotify.music). Mix both stores freely.", "items": { "type": "string" } }, "appNames": { "title": "App names (search both stores)", "type": "array", "description": "Just type the app name (e.g. \"Duolingo\"): the Actor finds it on the App Store and on Google Play.", "items": { "type": "string" } }, "stores": { "title": "Stores (for app names)", "type": "array", "description": "Which stores to search for app names.", "items": { "type": "string", "enum": [ "appstore", "googleplay" ], "enumTitles": [ "App Store", "Google Play" ] }, "default": [ "appstore", "googleplay" ] }, "countries": { "title": "Countries", "type": "array", "description": "Reviews differ per country: each country is a separate storefront. All 175 App Store storefronts are listed; Google Play uses the same codes.", "items": { "type": "string", "enum": [ "us", "gb", "ca", "au", "nz", "ie", "in", "sg", "za", "ng", "ph", "my", "fr", "be", "ch", "lu", "de", "at", "es", "mx", "ar", "co", "cl", "pe", "it", "pt", "br", "nl", "pl", "se", "dk", "no", "fi", "cz", "sk", "hu", "ro", "bg", "gr", "hr", "si", "rs", "ua", "tr", "il", "ae", "sa", "eg", "jp", "kr", "tw", "hk", "th", "vn", "id", "ee", "lv", "lt", "al", "ba", "by", "cy", "is", "xk", "mt", "md", "me", "mk", "ru", "af", "dz", "ao", "am", "az", "bh", "bj", "bw", "bf", "cm", "cv", "td", "cd", "cg", "ci", "ga", "gm", "ge", "gh", "gw", "iq", "jo", "ke", "kw", "lb", "lr", "ly", "mg", "mw", "ml", "mr", "mu", "ma", "mz", "na", "ne", "om", "qa", "rw", "st", "sn", "sc", "sl", "sz", "tz", "tn", "ug", "ye", "zm", "zw", "bd", "bt", "bn", "kh", "cn", "fj", "kz", "kg", "la", "mo", "mv", "fm", "mn", "mm", "nr", "np", "pk", "pg", "sb", "lk", "tj", "to", "tm", "uz", "vu", "ai", "ag", "bs", "bb", "bz", "bm", "bo", "vg", "ky", "cr", "dm", "do", "ec", "sv", "gd", "gt", "gy", "hn", "jm", "ms", "ni", "pa", "py", "kn", "lc", "vc", "sr", "tt", "tc", "uy", "ve" ], "enumTitles": [ "United States", "United Kingdom", "Canada", "Australia", "New Zealand", "Ireland", "India", "Singapore", "South Africa", "Nigeria", "Philippines", "Malaysia", "France", "Belgium", "Switzerland", "Luxembourg", "Germany", "Austria", "Spain", "Mexico", "Argentina", "Colombia", "Chile", "Peru", "Italy", "Portugal", "Brazil", "Netherlands", "Poland", "Sweden", "Denmark", "Norway", "Finland", "Czechia", "Slovakia", "Hungary", "Romania", "Bulgaria", "Greece", "Croatia", "Slovenia", "Serbia", "Ukraine", "Türkiye", "Israel", "United Arab Emirates", "Saudi Arabia", "Egypt", "Japan", "South Korea", "Taiwan", "Hong Kong", "Thailand", "Vietnam", "Indonesia", "Estonia", "Latvia", "Lithuania", "Albania", "Bosnia and Herzegovina", "Belarus", "Cyprus", "Iceland", "Kosovo", "Malta", "Moldova", "Montenegro", "North Macedonia", "Russia", "Afghanistan", "Algeria", "Angola", "Armenia", "Azerbaijan", "Bahrain", "Benin", "Botswana", "Burkina Faso", "Cameroon", "Cape Verde", "Chad", "Congo (DRC)", "Congo (Republic)", "Côte d'Ivoire", "Gabon", "Gambia", "Georgia", "Ghana", "Guinea-Bissau", "Iraq", "Jordan", "Kenya", "Kuwait", "Lebanon", "Liberia", "Libya", "Madagascar", "Malawi", "Mali", "Mauritania", "Mauritius", "Morocco", "Mozambique", "Namibia", "Niger", "Oman", "Qatar", "Rwanda", "São Tomé and Príncipe", "Senegal", "Seychelles", "Sierra Leone", "Eswatini", "Tanzania", "Tunisia", "Uganda", "Yemen", "Zambia", "Zimbabwe", "Bangladesh", "Bhutan", "Brunei", "Cambodia", "China", "Fiji", "Kazakhstan", "Kyrgyzstan", "Laos", "Macao", "Maldives", "Micronesia", "Mongolia", "Myanmar", "Nauru", "Nepal", "Pakistan", "Papua New Guinea", "Solomon Islands", "Sri Lanka", "Tajikistan", "Tonga", "Turkmenistan", "Uzbekistan", "Vanuatu", "Anguilla", "Antigua and Barbuda", "Bahamas", "Barbados", "Belize", "Bermuda", "Bolivia", "British Virgin Islands", "Cayman Islands", "Costa Rica", "Dominica", "Dominican Republic", "Ecuador", "El Salvador", "Grenada", "Guatemala", "Guyana", "Honduras", "Jamaica", "Montserrat", "Nicaragua", "Panama", "Paraguay", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Suriname", "Trinidad and Tobago", "Turks and Caicos Islands", "Uruguay", "Venezuela" ] }, "default": [ "us" ] }, "allCountries": { "title": "All countries", "type": "boolean", "description": "Collect reviews in all 175 countries above (every App Store storefront). Many requests: allow a few minutes per app.", "default": false }, "reviewLanguage": { "title": "Google Play review language", "type": "string", "description": "Optional, Google Play only. Two-letter code of the language the reviews are written in, e.g. \"fr\" for French-speaking reviews in Canada, \"es\" for Spanish reviews in the US. Empty: the main language of each country. The App Store has no language filter." }, "maxReviewsPerCountry": { "title": "Maximum reviews per app and country", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The App Store gives at most 500 recent reviews per country; Google Play has no such limit.", "default": 100 }, "sortBy": { "title": "Sort", "enum": [ "newest", "most_helpful" ], "type": "string", "description": "Which reviews first.", "default": "newest" }, "charts": { "title": "Top charts (free rows)", "type": "array", "description": "Pick one or more charts. They are read in each selected country (30 at most) and in each store selected above.", "items": { "type": "string", "enum": [ "topFree", "topPaid", "topGrossing" ], "enumTitles": [ "Top free", "Top paid", "Top grossing" ] }, "default": [] }, "chartCategory": { "title": "Chart category", "enum": [ "all", "books", "business", "education", "entertainment", "finance", "food", "games", "health", "lifestyle", "medical", "music", "navigation", "news", "photo", "productivity", "shopping", "social", "sports", "travel", "utilities", "weather" ], "type": "string", "description": "Same categories in both stores (e.g. Finance, Games, Health & Fitness).", "default": "all" }, "chartSize": { "title": "Apps per chart", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many ranked apps to read per chart and country (1-100).", "default": 10 }, "chartDevice": { "title": "App Store chart device", "enum": [ "iphone", "ipad" ], "type": "string", "description": "App Store only: the iPhone or the iPad charts.", "default": "iphone" }, "reviewsFromCharts": { "title": "Collect their reviews", "type": "boolean", "description": "Also collect the reviews of every ranked app (billed per review, with all the filters below). Uncheck to get the charts only, for free.", "default": true }, "rankKeywords": { "title": "Keywords to rank (ASO, free rows)", "type": "array", "description": "Search words, e.g. \"budget app\", \"expense tracker\". Up to 100 keywords. Leave the apps empty to just see who ranks on each keyword.", "default": [], "items": { "type": "string" } }, "rankCountries": { "title": "Countries for keyword rankings", "type": "array", "description": "Leave empty to use the review countries above (30 at most).", "items": { "type": "string", "enum": [ "us", "gb", "ca", "au", "nz", "ie", "in", "sg", "za", "ng", "ph", "my", "fr", "be", "ch", "lu", "de", "at", "es", "mx", "ar", "co", "cl", "pe", "it", "pt", "br", "nl", "pl", "se", "dk", "no", "fi", "cz", "sk", "hu", "ro", "bg", "gr", "hr", "si", "rs", "ua", "tr", "il", "ae", "sa", "eg", "jp", "kr", "tw", "hk", "th", "vn", "id", "ee", "lv", "lt", "al", "ba", "by", "cy", "is", "xk", "mt", "md", "me", "mk", "ru", "af", "dz", "ao", "am", "az", "bh", "bj", "bw", "bf", "cm", "cv", "td", "cd", "cg", "ci", "ga", "gm", "ge", "gh", "gw", "iq", "jo", "ke", "kw", "lb", "lr", "ly", "mg", "mw", "ml", "mr", "mu", "ma", "mz", "na", "ne", "om", "qa", "rw", "st", "sn", "sc", "sl", "sz", "tz", "tn", "ug", "ye", "zm", "zw", "bd", "bt", "bn", "kh", "cn", "fj", "kz", "kg", "la", "mo", "mv", "fm", "mn", "mm", "nr", "np", "pk", "pg", "sb", "lk", "tj", "to", "tm", "uz", "vu", "ai", "ag", "bs", "bb", "bz", "bm", "bo", "vg", "ky", "cr", "dm", "do", "ec", "sv", "gd", "gt", "gy", "hn", "jm", "ms", "ni", "pa", "py", "kn", "lc", "vc", "sr", "tt", "tc", "uy", "ve" ], "enumTitles": [ "United States", "United Kingdom", "Canada", "Australia", "New Zealand", "Ireland", "India", "Singapore", "South Africa", "Nigeria", "Philippines", "Malaysia", "France", "Belgium", "Switzerland", "Luxembourg", "Germany", "Austria", "Spain", "Mexico", "Argentina", "Colombia", "Chile", "Peru", "Italy", "Portugal", "Brazil", "Netherlands", "Poland", "Sweden", "Denmark", "Norway", "Finland", "Czechia", "Slovakia", "Hungary", "Romania", "Bulgaria", "Greece", "Croatia", "Slovenia", "Serbia", "Ukraine", "Türkiye", "Israel", "United Arab Emirates", "Saudi Arabia", "Egypt", "Japan", "South Korea", "Taiwan", "Hong Kong", "Thailand", "Vietnam", "Indonesia", "Estonia", "Latvia", "Lithuania", "Albania", "Bosnia and Herzegovina", "Belarus", "Cyprus", "Iceland", "Kosovo", "Malta", "Moldova", "Montenegro", "North Macedonia", "Russia", "Afghanistan", "Algeria", "Angola", "Armenia", "Azerbaijan", "Bahrain", "Benin", "Botswana", "Burkina Faso", "Cameroon", "Cape Verde", "Chad", "Congo (DRC)", "Congo (Republic)", "Côte d'Ivoire", "Gabon", "Gambia", "Georgia", "Ghana", "Guinea-Bissau", "Iraq", "Jordan", "Kenya", "Kuwait", "Lebanon", "Liberia", "Libya", "Madagascar", "Malawi", "Mali", "Mauritania", "Mauritius", "Morocco", "Mozambique", "Namibia", "Niger", "Oman", "Qatar", "Rwanda", "São Tomé and Príncipe", "Senegal", "Seychelles", "Sierra Leone", "Eswatini", "Tanzania", "Tunisia", "Uganda", "Yemen", "Zambia", "Zimbabwe", "Bangladesh", "Bhutan", "Brunei", "Cambodia", "China", "Fiji", "Kazakhstan", "Kyrgyzstan", "Laos", "Macao", "Maldives", "Micronesia", "Mongolia", "Myanmar", "Nauru", "Nepal", "Pakistan", "Papua New Guinea", "Solomon Islands", "Sri Lanka", "Tajikistan", "Tonga", "Turkmenistan", "Uzbekistan", "Vanuatu", "Anguilla", "Antigua and Barbuda", "Bahamas", "Barbados", "Belize", "Bermuda", "Bolivia", "British Virgin Islands", "Cayman Islands", "Costa Rica", "Dominica", "Dominican Republic", "Ecuador", "El Salvador", "Grenada", "Guatemala", "Guyana", "Honduras", "Jamaica", "Montserrat", "Nicaragua", "Panama", "Paraguay", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Suriname", "Trinidad and Tobago", "Turks and Caicos Islands", "Uruguay", "Venezuela" ] }, "default": [] }, "skipReviews": { "title": "Rankings and charts only (no reviews)", "type": "boolean", "description": "Skip the reviews: the run returns only the free keyword rank and chart rows (and costs only the run start).", "default": false }, "rankAlertMinChange": { "title": "Alert when an app moves by at least", "minimum": 1, "maximum": 100, "type": "integer", "description": "With a monitor name and an alert channel: alert when a tracked app moves by at least this many places on a keyword, or enters or leaves the results.", "default": 5 }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep reviews rated at least this (1-5)." }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "E.g. 2 = only negative reviews." }, "reviewedAfter": { "title": "Reviewed after", "type": "string", "description": "Only reviews written after this date (YYYY-MM-DD)." }, "keywords": { "title": "Only reviews mentioning", "type": "array", "description": "Keep only reviews whose title or text contains one of these words (case and accents ignored; \"crash\" also matches \"crashes\" and \"crashing\"). E.g. crash, login, subscription, battery. Empty = all reviews.", "default": [], "items": { "type": "string" } }, "appVersions": { "title": "Only these app versions", "type": "array", "description": "Keep only reviews written on these app versions; \"6.2\" matches 6.2, 6.2.1, 6.2.10. Useful after a release. Reviews without a version (App Store web fallback) are left out when this is set. Empty = all versions.", "default": [], "items": { "type": "string" } }, "developerReply": { "title": "Developer reply", "enum": [ "any", "replied", "notReplied" ], "type": "string", "description": "Google Play only (Apple's review feed does not include developer replies, so App Store reviews are not filtered). \"Still without a reply\" with a maximum rating of 2 gives the complaints nobody answered yet.", "default": "any" }, "includeAppDetails": { "title": "Add app details (free)", "type": "boolean", "description": "One item per app: rating, number of ratings, version, installs, developer, genre.", "default": true }, "includeSummary": { "title": "Add a free summary per app", "type": "boolean", "description": "Rating distribution, rating by version and by country, developer reply rate, topics of negative reviews.", "default": true }, "includeReviewerNames": { "title": "Include reviewer names", "type": "boolean", "description": "Off by default: reviewer names are personal data and are rarely needed for analysis.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Set a name and schedule the Actor (e.g. every hour): each run returns only new reviews, and can alert you on negative ones." }, "alertMaxRating": { "title": "Alert on reviews rated at most", "minimum": 1, "maximum": 5, "type": "integer", "description": "Monitoring: send an alert for each new review with this rating or lower (e.g. 2 = 1 and 2 stars).", "default": 2 }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Alerts on Telegram: create a bot with @BotFather and paste its token." }, "telegramChatId": { "title": "Telegram chat ID", "type": "string", "description": "Your chat ID (send a message to your bot, then open api.telegram.org/bot/getUpdates)." }, "discordWebhookUrl": { "title": "Discord webhook URL", "type": "string", "description": "Alerts in a Discord channel: Channel settings → Integrations → Webhooks." }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Alerts in Slack: create an Incoming Webhook for your channel." }, "webhookUrl": { "title": "Webhook URL (JSON)", "type": "string", "description": "Receives one POST per run with the alerted reviews (Make, Zapier, n8n, your helpdesk…)." }, "maxNotifications": { "title": "Maximum alerts per run", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of alert messages per run.", "default": 30 } } }, "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 } } } } } } } } } }