{ "openapi": "3.0.1", "info": { "title": "⭐ App Store Reviews Scraper - iOS & macOS Reviews", "description": "Returns customer reviews of any iOS or macOS app on the Apple App Store: star rating, title, full text, author, country and date. Filter by stars, or use monitor mode to get only reviews written since the last run (1-star alerts). Pick the app by link or id and the country store. No login needed.", "version": "1.0", "x-build-id": "GEvrc8bwITssDcGv5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benthepythondev~appstore-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benthepythondev-appstore-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/benthepythondev~appstore-reviews-scraper/runs": { "post": { "operationId": "runs-sync-benthepythondev-appstore-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/benthepythondev~appstore-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-benthepythondev-appstore-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": { "appIds": { "title": "App IDs", "maxItems": 100, "type": "array", "description": "List of App Store app IDs to scrape reviews from (e.g., 333903271 for Twitter/X). Up to 100 apps per run.", "items": { "type": "string" }, "default": [ "333903271" ] }, "appUrls": { "title": "App Store URLs", "maxItems": 100, "type": "array", "description": "List of App Store URLs to scrape reviews from (alternative to app IDs). Up to 100 per run.", "items": { "type": "string" } }, "countries": { "title": "Countries", "maxItems": 48, "type": "array", "description": "Country codes to scrape reviews from (e.g., us, gb, de, fr, jp). Up to 48 countries.", "items": { "type": "string" }, "default": [ "us" ] }, "maxReviews": { "title": "Maximum Reviews per App/Country", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Maximum number of reviews to save per app per country (up to 2,000 with sortBy both, else 1,000; 0 = 500). With a star filter it counts the reviews inside the range. Keep small for tests.", "default": 5 }, "sortBy": { "title": "Sort Reviews By", "enum": [ "mostRecent", "mostHelpful", "both" ], "type": "string", "description": "How to sort the reviews. Both reads the newest and the most helpful reviews (up to 1,000 each) and removes duplicates before maxReviews is applied.", "default": "mostRecent" }, "minRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Save only reviews with at least this many stars (1-5). Filtered reviews are not saved and not charged. Set minRating 1 and maxRating 1 for 1-star alerts." }, "maxRating": { "title": "Maximum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Save only reviews with at most this many stars (1-5). Filtered reviews are not saved and not charged." }, "monitorMode": { "title": "Monitor mode (only new reviews)", "type": "boolean", "description": "For scheduled runs. The first run records the reviews that exist now for each app and country and saves nothing. Every later run saves and charges only reviews written since the previous run. The seen review ids are kept in the named key-value store 'appstore-reviews-monitor' on your account. Reads newest first; set maxReviews to more reviews than the app gets between two runs.", "default": false }, "delaySeconds": { "title": "Delay Between Requests (seconds)", "minimum": 0.3, "maximum": 5, "type": "number", "description": "Delay between API requests", "default": 0.5 } } }, "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 } } } } } } } } } }