{
"openapi": "3.0.1",
"info": {
"title": "App Store Reviews Scraper - Apple iOS Reviews & Ratings",
"description": "Export Apple App Store reviews for any iPhone or iPad app from many countries: rating, title, text, author, date and developer reply, plus app details. Paste a link, app ID, bundle ID or name. Star, date and keyword filters and 'only new reviews' monitoring.",
"version": "1.0",
"x-build-id": "xwJNeV6GpI7ma4I2b"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/despottt~app-store-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-despottt-app-store-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/despottt~app-store-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-despottt-app-store-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/despottt~app-store-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-despottt-app-store-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",
"required": [
"apps"
],
"properties": {
"apps": {
"title": "📱 Apps",
"type": "array",
"description": "One per line: App Store link (https://apps.apple.com/us/app/instagram/id389801252), numeric ID (389801252), bundle ID (com.spotify.client) or app name.",
"items": {
"type": "string"
}
},
"countries": {
"title": "App Store countries",
"type": "array",
"description": "Each country has its own reviews; pick several for more. Empty = United States, or the country in the app link.",
"items": {
"type": "string",
"enumSuggestedValues": [
"us",
"gb",
"de",
"fr",
"it",
"es",
"ca",
"au",
"in",
"br",
"nl",
"jp",
"af",
"al",
"dz",
"ad",
"ao",
"ai",
"ag",
"ar",
"am",
"at",
"az",
"bs",
"bh",
"bd",
"bb",
"by",
"be",
"bz",
"bj",
"bm",
"bt",
"bo",
"ba",
"bw",
"bn",
"bg",
"bf",
"kh",
"cm",
"cv",
"ky",
"cf",
"td",
"cl",
"cn",
"co",
"cg",
"cd",
"cr",
"ci",
"hr",
"cy",
"cz",
"dk",
"dm",
"do",
"ec",
"eg",
"sv",
"ee",
"et",
"fj",
"fi",
"ga",
"gm",
"ge",
"gh",
"gr",
"gd",
"gt",
"gn",
"gw",
"gy",
"hn",
"hk",
"hu",
"is",
"id",
"iq",
"ie",
"il",
"jm",
"jo",
"kz",
"ke",
"kr",
"kw",
"kg",
"la",
"lv",
"lb",
"lr",
"ly",
"li",
"lt",
"lu",
"mo",
"mk",
"mg",
"mw",
"my",
"mv",
"ml",
"mt",
"mr",
"mu",
"mx",
"fm",
"md",
"mc",
"mn",
"me",
"ms",
"ma",
"mz",
"mm",
"na",
"nr",
"np",
"nz",
"ni",
"ne",
"ng",
"no",
"om",
"pk",
"pw",
"ps",
"pa",
"pg",
"py",
"pe",
"ph",
"pl",
"pt",
"qa",
"ro",
"ru",
"rw",
"kn",
"lc",
"vc",
"ws",
"st",
"sa",
"sn",
"rs",
"sc",
"sl",
"sg",
"sk",
"si",
"sb",
"za",
"lk",
"sr",
"sz",
"se",
"ch",
"tw",
"tj",
"tz",
"th",
"to",
"tt",
"tn",
"tr",
"tm",
"tc",
"ug",
"ua",
"ae",
"uy",
"uz",
"vu",
"ve",
"vn",
"vg",
"ye",
"zm",
"zw"
],
"enumTitles": [
"United States (US)",
"United Kingdom (GB)",
"Germany (DE)",
"France (FR)",
"Italy (IT)",
"Spain (ES)",
"Canada (CA)",
"Australia (AU)",
"India (IN)",
"Brazil (BR)",
"Netherlands (NL)",
"Japan (JP)",
"Afghanistan (AF)",
"Albania (AL)",
"Algeria (DZ)",
"Andorra (AD)",
"Angola (AO)",
"Anguilla (AI)",
"Antigua and Barbuda (AG)",
"Argentina (AR)",
"Armenia (AM)",
"Austria (AT)",
"Azerbaijan (AZ)",
"Bahamas (BS)",
"Bahrain (BH)",
"Bangladesh (BD)",
"Barbados (BB)",
"Belarus (BY)",
"Belgium (BE)",
"Belize (BZ)",
"Benin (BJ)",
"Bermuda (BM)",
"Bhutan (BT)",
"Bolivia (BO)",
"Bosnia and Herzegovina (BA)",
"Botswana (BW)",
"Brunei Darussalam (BN)",
"Bulgaria (BG)",
"Burkina Faso (BF)",
"Cambodia (KH)",
"Cameroon (CM)",
"Cape Verde (CV)",
"Cayman Islands (KY)",
"Central African Republic (CF)",
"Chad (TD)",
"Chile (CL)",
"China (CN)",
"Colombia (CO)",
"Congo (CG)",
"Congo, the Democratic Republic of the (CD)",
"Costa Rica (CR)",
"Cote D'ivoire (CI)",
"Croatia (HR)",
"Cyprus (CY)",
"Czech Republic (CZ)",
"Denmark (DK)",
"Dominica (DM)",
"Dominican Republic (DO)",
"Ecuador (EC)",
"Egypt (EG)",
"El Salvador (SV)",
"Estonia (EE)",
"Ethiopia (ET)",
"Fiji (FJ)",
"Finland (FI)",
"Gabon (GA)",
"Gambia (GM)",
"Georgia (GE)",
"Ghana (GH)",
"Greece (GR)",
"Grenada (GD)",
"Guatemala (GT)",
"Guinea (GN)",
"Guinea-Bissau (GW)",
"Guyana (GY)",
"Honduras (HN)",
"Hong Kong (HK)",
"Hungary (HU)",
"Iceland (IS)",
"Indonesia (ID)",
"Iraq (IQ)",
"Ireland (IE)",
"Israel (IL)",
"Jamaica (JM)",
"Jordan (JO)",
"Kazakhstan (KZ)",
"Kenya (KE)",
"Korea, Republic of (KR)",
"Kuwait (KW)",
"Kyrgyzstan (KG)",
"Lao People's Democratic Republic (LA)",
"Latvia (LV)",
"Lebanon (LB)",
"Liberia (LR)",
"Libyan Arab Jamahiriya (LY)",
"Liechtenstein (LI)",
"Lithuania (LT)",
"Luxembourg (LU)",
"Macao (MO)",
"Macedonia, the Former Yugoslav Republic of (MK)",
"Madagascar (MG)",
"Malawi (MW)",
"Malaysia (MY)",
"Maldives (MV)",
"Mali (ML)",
"Malta (MT)",
"Mauritania (MR)",
"Mauritius (MU)",
"Mexico (MX)",
"Micronesia, Federated States of (FM)",
"Moldova, Republic of (MD)",
"Monaco (MC)",
"Mongolia (MN)",
"Montenegro (ME)",
"Montserrat (MS)",
"Morocco (MA)",
"Mozambique (MZ)",
"Myanmar (MM)",
"Namibia (NA)",
"Nauru (NR)",
"Nepal (NP)",
"New Zealand (NZ)",
"Nicaragua (NI)",
"Niger (NE)",
"Nigeria (NG)",
"Norway (NO)",
"Oman (OM)",
"Pakistan (PK)",
"Palau (PW)",
"Palestinian Territory, Occupied (PS)",
"Panama (PA)",
"Papua New Guinea (PG)",
"Paraguay (PY)",
"Peru (PE)",
"Philippines (PH)",
"Poland (PL)",
"Portugal (PT)",
"Qatar (QA)",
"Romania (RO)",
"Russian Federation (RU)",
"Rwanda (RW)",
"Saint Kitts and Nevis (KN)",
"Saint Lucia (LC)",
"Saint Vincent and the Grenadines (VC)",
"Samoa (WS)",
"Sao Tome and Principe (ST)",
"Saudi Arabia (SA)",
"Senegal (SN)",
"Serbia (RS)",
"Seychelles (SC)",
"Sierra Leone (SL)",
"Singapore (SG)",
"Slovakia (SK)",
"Slovenia (SI)",
"Solomon Islands (SB)",
"South Africa (ZA)",
"Sri Lanka (LK)",
"Suriname (SR)",
"Swaziland (SZ)",
"Sweden (SE)",
"Switzerland (CH)",
"Taiwan, Province of China (TW)",
"Tajikistan (TJ)",
"Tanzania, United Republic of (TZ)",
"Thailand (TH)",
"Tonga (TO)",
"Trinidad and Tobago (TT)",
"Tunisia (TN)",
"Turkey (TR)",
"Turkmenistan (TM)",
"Turks and Caicos Islands (TC)",
"Uganda (UG)",
"Ukraine (UA)",
"United Arab Emirates (AE)",
"Uruguay (UY)",
"Uzbekistan (UZ)",
"Vanuatu (VU)",
"Venezuela (VE)",
"Viet Nam (VN)",
"Virgin Islands, British (VG)",
"Yemen (YE)",
"Zambia (ZM)",
"Zimbabwe (ZW)"
]
},
"default": []
},
"sortBy": {
"title": "Sort reviews by",
"enum": [
"mostRecent",
"mostHelpful"
],
"type": "string",
"description": "Most recent is needed for date filters and monitoring.",
"default": "mostRecent"
},
"maxReviewsPerApp": {
"title": "Max reviews per app and country",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Default 500. Popular apps have thousands of reviews in each country (up to 10,000 per app and country). With star or keyword filters, up to 5× this number is read to find matches.",
"default": 500
},
"maxItems": {
"title": "Max reviews in total",
"minimum": 0,
"maximum": 10000000,
"type": "integer",
"description": "0 = no limit.",
"default": 0
},
"minRating": {
"title": "Min stars",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "Lowest star rating to keep (1-5).",
"default": 1
},
"maxRating": {
"title": "Max stars",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "Tip: set 2 to get only complaints.",
"default": 5
},
"postedWithinDays": {
"title": "Posted in the last … days",
"minimum": 0,
"maximum": 3650,
"type": "integer",
"description": "0 = any time.",
"default": 0
},
"fromDate": {
"title": "Posted on or after",
"type": "string",
"description": "Only reviews from this date on."
},
"keywords": {
"title": "Keywords (keep if any matches)",
"type": "array",
"description": "Whole words in the title or text, e.g. crash, login, price.",
"default": [],
"items": {
"type": "string"
}
},
"onlyNew": {
"title": "Only new reviews since the last run",
"type": "boolean",
"description": "Remember the newest review per app and country; the next run returns only newer ones.",
"default": false
},
"stateKey": {
"title": "Monitor name (optional)",
"type": "string",
"description": "Give each monitor its own name if you run several."
},
"includeAppDetails": {
"title": "Add app details to each review",
"type": "boolean",
"description": "App name, developer, bundle ID, average rating, rating count, version, genre, price and icon.",
"default": true
},
"includeEmptyApps": {
"title": "List apps with no matching reviews",
"type": "boolean",
"description": "Adds a free row for app/country pairs with no matching reviews.",
"default": 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
}
}
}
}
}
}
}
}
}
}