{ "openapi": "3.0.1", "info": { "title": "App Store Reviews Scraper | Translation & All Countries", "description": "Pull Apple App Store reviews across 160+ country storefront with auto-translation and sentiment analysis. Get ratings, title/body, versions, authors, timestamps, helpful votes, and country codes in clean JSON/CSV. Ideal for sentiment tracking, localization QA, and competitor monitoring.", "version": "0.0", "x-build-id": "GnJdwD7srsC1mPXdL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~app-store-global-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-app-store-global-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/fatihtahta~app-store-global-reviews-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-app-store-global-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/fatihtahta~app-store-global-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-app-store-global-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": { "startUrls": { "title": "Add App Store URLs or App IDs", "type": "array", "description": "Enter one or more Apple App Store app URLs, such as `https://apps.apple.com/app/id1221965482`, or numeric App IDs, such as `1221965482`. Each value becomes a review collection target for the selected storefront countries.", "items": { "type": "string" } }, "countries": { "title": "Choose App Store Countries", "uniqueItems": true, "type": "array", "description": "Pick one or more country storefronts to collect reviews from. Choose `Every country` when you want broad international coverage, or select specific markets when you need a focused regional dataset.", "items": { "type": "string", "enum": [ "__all__", "af", "al", "dz", "ao", "ai", "ag", "ar", "am", "au", "at", "az", "bs", "bh", "bd", "bb", "by", "be", "bz", "bm", "bo", "bw", "br", "vg", "bn", "bg", "kh", "cm", "ca", "cv", "ky", "cl", "cn", "co", "cr", "hr", "cy", "cz", "dk", "dm", "do", "ec", "eg", "sv", "ee", "sz", "fj", "fi", "fr", "ga", "gm", "ge", "de", "gh", "gr", "gd", "gt", "gw", "gy", "hn", "hk", "hu", "is", "in", "id", "ie", "il", "it", "jm", "jp", "jo", "kz", "ke", "kw", "kg", "la", "lv", "lb", "lr", "li", "lt", "lu", "mo", "mg", "mw", "my", "mv", "ml", "mt", "mr", "mu", "mx", "md", "mn", "ms", "ma", "mz", "mm", "na", "np", "nl", "nz", "ni", "ne", "ng", "mk", "no", "om", "pk", "pa", "pg", "py", "pe", "ph", "pl", "pt", "qa", "ro", "ru", "rw", "sa", "sn", "rs", "sc", "sl", "sg", "sk", "si", "sb", "za", "kr", "es", "lk", "kn", "lc", "vc", "sr", "se", "ch", "st", "tw", "tj", "tz", "th", "tt", "tn", "tr", "tm", "tc", "ug", "ua", "ae", "gb", "us", "uy", "uz", "ve", "vn", "ye", "zm", "zw" ], "enumTitles": [ "Every country 🌍", "AF – Afghanistan 🇦🇫", "AL – Albania 🇦🇱", "DZ – Algeria 🇩🇿", "AO – Angola 🇦🇴", "AI – Anguilla 🇦🇮", "AG – Antigua and Barbuda 🇦🇬", "AR – Argentina 🇦🇷", "AM – Armenia 🇦🇲", "AU – Australia 🇦🇺", "AT – Austria 🇦🇹", "AZ – Azerbaijan 🇦🇿", "BS – Bahamas 🇧🇸", "BH – Bahrain 🇧🇭", "BD – Bangladesh 🇧🇩", "BB – Barbados 🇧🇧", "BY – Belarus 🇧🇾", "BE – Belgium 🇧🇪", "BZ – Belize 🇧🇿", "BM – Bermuda 🇧🇲", "BO – Bolivia 🇧🇴", "BW – Botswana 🇧🇼", "BR – Brazil 🇧🇷", "VG – British Virgin Islands 🇻🇬", "BN – Brunei 🇧🇳", "BG – Bulgaria 🇧🇬", "KH – Cambodia 🇰🇭", "CM – Cameroon 🇨🇲", "CA – Canada 🇨🇦", "CV – Cape Verde 🇨🇻", "KY – Cayman Islands 🇰🇾", "CL – Chile 🇨🇱", "CN – China 🇨🇳", "CO – Colombia 🇨🇴", "CR – Costa Rica 🇨🇷", "HR – Croatia 🇭🇷", "CY – Cyprus 🇨🇾", "CZ – Czech Republic 🇨🇿", "DK – Denmark 🇩🇰", "DM – Dominica 🇩🇲", "DO – Dominican Republic 🇩🇴", "EC – Ecuador 🇪🇨", "EG – Egypt 🇪🇬", "SV – El Salvador 🇸🇻", "EE – Estonia 🇪🇪", "SZ – Eswatini 🇸🇿", "FJ – Fiji 🇫🇯", "FI – Finland 🇫🇮", "FR – France 🇫🇷", "GA – Gabon 🇬🇦", "GM – Gambia 🇬🇲", "GE – Georgia 🇬🇪", "DE – Germany 🇩🇪", "GH – Ghana 🇬🇭", "GR – Greece 🇬🇷", "GD – Grenada 🇬🇩", "GT – Guatemala 🇬🇹", "GW – Guinea-Bissau 🇬🇼", "GY – Guyana 🇬🇾", "HN – Honduras 🇭🇳", "HK – Hong Kong 🇭🇰", "HU – Hungary 🇭🇺", "IS – Iceland 🇮🇸", "IN – India 🇮🇳", "ID – Indonesia 🇮🇩", "IE – Ireland 🇮🇪", "IL – Israel 🇮🇱", "IT – Italy 🇮🇹", "JM – Jamaica 🇯🇲", "JP – Japan 🇯🇵", "JO – Jordan 🇯🇴", "KZ – Kazakhstan 🇰🇿", "KE – Kenya 🇰🇪", "KW – Kuwait 🇰🇼", "KG – Kyrgyzstan 🇰🇬", "LA – Laos 🇱🇦", "LV – Latvia 🇱🇻", "LB – Lebanon 🇱🇧", "LR – Liberia 🇱🇷", "LI – Liechtenstein 🇱🇮", "LT – Lithuania 🇱🇹", "LU – Luxembourg 🇱🇺", "MO – Macau 🇲🇴", "MG – Madagascar 🇲🇬", "MW – Malawi 🇲🇼", "MY – Malaysia 🇲🇾", "MV – Maldives 🇲🇻", "ML – Mali 🇲🇱", "MT – Malta 🇲🇹", "MR – Mauritania 🇲🇷", "MU – Mauritius 🇲🇺", "MX – Mexico 🇲🇽", "MD – Moldova 🇲🇩", "MN – Mongolia 🇲🇳", "MS – Montserrat 🇲🇸", "MA – Morocco 🇲🇦", "MZ – Mozambique 🇲🇿", "MM – Myanmar 🇲🇲", "NA – Namibia 🇳🇦", "NP – Nepal 🇳🇵", "NL – Netherlands 🇳🇱", "NZ – New Zealand 🇳🇿", "NI – Nicaragua 🇳🇮", "NE – Niger 🇳🇵", "NG – Nigeria 🇳🇬", "MK – North Macedonia 🇲🇰", "NO – Norway 🇳🇴", "OM – Oman 🇴🇲", "PK – Pakistan 🇵🇰", "PA – Panama 🇵🇦", "PG – Papua New Guinea 🇵🇬", "PY – Paraguay 🇵🇾", "PE – Peru 🇵🇪", "PH – Philippines 🇵🇭", "PL – Poland 🇵🇱", "PT – Portugal 🇵🇹", "QA – Qatar 🇶🇦", "RO – Romania 🇷🇴", "RU – Russia 🇷🇺", "RW – Rwanda 🇷🇼", "SA – Saudi Arabia 🇸🇦", "SN – Senegal 🇸🇳", "RS – Serbia 🇷🇸", "SC – Seychelles 🇸🇨", "SL – Sierra Leone 🇸🇱", "SG – Singapore 🇸🇬", "SK – Slovakia 🇸🇰", "SI – Slovenia 🇸🇮", "SB – Solomon Islands 🇸🇧", "ZA – South Africa 🇿🇦", "KR – South Korea 🇰🇷", "ES – Spain 🇪🇸", "LK – Sri Lanka 🇱🇰", "KN – St. Kitts and Nevis 🇰🇳", "LC – St. Lucia 🇱🇨", "VC – St. Vincent and the Grenadines 🇻🇨", "SR – Suriname 🇸🇷", "SE – Sweden 🇸🇪", "CH – Switzerland 🇨🇭", "ST – São Tomé and Príncipe 🇸🇹", "TW – Taiwan 🇹🇼", "TJ – Tajikistan 🇹🇯", "TZ – Tanzania 🇹🇿", "TH – Thailand 🇹🇭", "TT – Trinidad and Tobago 🇹🇹", "TN – Tunisia 🇹🇳", "TR – Turkey 🇹🇷", "TM – Turkmenistan 🇹🇲", "TC – Turks and Caicos Islands 🇹🇨", "UG – Uganda 🇺🇬", "UA – Ukraine 🇺🇦", "AE – United Arab Emirates 🇦🇪", "GB – United Kingdom 🇬🇧", "US – United States 🇺🇸", "UY – Uruguay 🇺🇾", "UZ – Uzbekistan 🇺🇿", "VE – Venezuela 🇻🇪", "VN – Vietnam 🇻🇳", "YE – Yemen 🇾🇪", "ZM – Zambia 🇿🇲", "ZW – Zimbabwe 🇿🇼" ] }, "default": [ "__all__" ] }, "sortBy": { "title": "Choose How Reviews Are Sorted", "enum": [ "mostrecent", "mosthelpful" ], "type": "string", "description": "Select `Most recent` to prioritize the latest reviews, or `Most helpful` to prioritize reviews with more helpfulness votes. This affects which reviews are reached first, especially when a result limit is set.", "default": "mostrecent" }, "maximize_coverage": { "title": "Maximize Unique Review Coverage", "type": "boolean", "description": "Turn this on to collect a broader set of unique reviews when the first collection pass cannot fill your requested limit. The actor keeps duplicate reviews out of the dataset, so this option is best for larger runs where you want the most complete review sample available.", "default": true }, "limit": { "title": "Set the Maximum Reviews to Save", "minimum": 10, "type": "integer", "description": "Enter the maximum number of reviews to save per collection target. Use a smaller value for testing or lightweight monitoring, and a larger value when you need broader review coverage.", "default": 50000 }, "sentiment_analysis": { "title": "Add Sentiment Labels to Collected Reviews", "type": "boolean", "description": "Turn this on to classify each scraped review as positive, negative, or neutral and save the result with the review record. Use it to compare customer mood by app, country, rating, or app version.", "default": false }, "translation": { "title": "Translate Review Text", "type": "boolean", "description": "Turn this on to detect each review's language and add translated versions of the review title and content. Translation results are saved alongside the original text.", "default": false }, "translateTo": { "title": "Choose the Translation Language", "enum": [ "en-US", "en-GB", "en-CA", "en-AU", "en-NZ", "en-IE", "en-ZA", "en-IN", "en-SG", "es-ES", "es-419", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-US", "pt-BR", "pt-PT", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "de-DE", "de-AT", "de-CH", "zh-Hans", "zh-Hant", "zh-CN", "zh-TW", "zh-HK", "ar", "ar-SA", "ar-EG", "ar-AE", "it-IT", "nl-NL", "sv-SE", "no-NO", "da-DK", "fi-FI", "pl-PL", "cs-CZ", "sk-SK", "hu-HU", "ro-RO", "el-GR", "bg-BG", "hr-HR", "sl-SI", "sr", "uk-UA", "ru-RU", "lt-LT", "lv-LV", "et-EE", "is-IS", "ga-IE", "tr-TR", "he-IL", "fa-IR", "hi-IN", "bn-BD", "ta-IN", "te-IN", "mr-IN", "ur-PK", "id-ID", "ms-MY", "th-TH", "vi-VN", "fil-PH", "ja-JP", "ko-KR", "sw-KE", "sw-TZ", "am-ET", "ha-NG", "yo-NG", "ig-NG", "zu-ZA", "af-ZA" ], "type": "string", "description": "Select the language and locale to use for translated review titles and content. The default is English (United States), which works well for shared reports and cross-market analysis.", "default": "en-US" }, "lingoKey": { "title": "Use Your Own Lingo.dev API Key", "type": "string", "description": "Optionally enter a Lingo.dev API key for review translation. When a key is provided, translations use your Lingo.dev account instead of actor-managed translated-word billing." } } }, "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 } } } } } } } } } }