{ "openapi": "3.0.1", "info": { "title": "App Store Reviews Scraper: iOS Reviews from 174 Countries", "description": "Scrape Apple App Store reviews for iPhone and iPad apps in any of 174 countries: stars, title, text, app version, helpful votes, date and the developer's response, with app name and country on every row. Up to 1,000 reviews per app per country, newest or most helpful first. No login.", "version": "0.1", "x-build-id": "hcbFgzZ3izOpSF3aR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~app-store-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~app-store-reviews-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-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/themineworks~app-store-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-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 app per line: the numeric App Store id (310633997) or an App Store link (https://apps.apple.com/us/app/whatsapp-messenger/id310633997). The country in a link is ignored; pick countries below. Up to 200 apps per run; repeats are read once.", "default": [ "310633997", "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580" ], "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two letter App Store country codes, one per line, for example us, gb, in, de, jp. Each country is read separately and every row says which country it came from. Countries where the app is not sold are skipped and never charged.", "default": [ "us" ], "items": { "type": "string" } }, "allCountries": { "title": "Read every App Store country", "type": "boolean", "description": "Reads all 174 App Store countries instead of the list above. Most apps have written reviews in a few dozen of them; the rest cost one small check each and are never charged.", "default": false }, "maxReviewsPerCountry": { "title": "Max reviews per app in each country", "minimum": 20, "maximum": 1000, "type": "integer", "description": "How many reviews to collect for each app in each country, 20 to 1,000. Apple's public feed holds up to 500 reviews per country for one sort order (10 pages of 50); with sort Both, up to about 1,000.", "default": 100 }, "sort": { "title": "Sort", "enum": [ "mostRecent", "mostHelpful", "both" ], "type": "string", "description": "Most recent is the one to use for monitoring. Most helpful reaches back years. Both reads the most recent list, then the most helpful list, and skips reviews already collected.", "default": "mostRecent" }, "includeDeveloperResponses": { "title": "Include developer responses", "type": "boolean", "description": "Adds the developer's reply to reviews that have one. Apple only shows replies on the 10 featured reviews of each country's App Store page (the top of the most helpful list), so replies appear when the sort is Most helpful or Both. Costs one extra page read per country.", "default": true }, "onlyNewReviews": { "title": "Only reviews not delivered before", "type": "boolean", "description": "For schedules: skip reviews an earlier run of this actor in your account already delivered, so each run returns and charges only new ones. With Most recent first, reading a country stops at the first page that holds only reviews you already have.", "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 } } } } } } } } } }