{ "openapi": "3.0.1", "info": { "title": "App Store Reviews Scraper (Unlimited, All Countries)", "description": "Scrape Apple App Store reviews beyond the 500-review RSS limit: rating, title, text, date and developer reply, for any app in any country. Sort by recent, helpful, favorable or critical; filter by stars, keywords and date. Monitoring mode for new reviews.", "version": "0.0", "x-build-id": "c2xxQChRJyj7bO5V5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mattzer~app-store-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mattzer-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/mattzer~app-store-reviews-scraper/runs": { "post": { "operationId": "runs-sync-mattzer-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/mattzer~app-store-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-mattzer-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": "App Store URLs (https://apps.apple.com/us/app/spotify/id324684580), app IDs (324684580) or bundle IDs (com.spotify.client).", "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app and country", "minimum": 0, "maximum": 100000, "type": "integer", "description": "How many reviews to fetch per app in each country (0 = app details only). Up to 100,000 — far beyond the 500 limit of Apple's RSS feed.", "default": 100 }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter App Store storefronts (us, gb, fr, de, jp, br…). Reviews are separate per country — add several to cover every market. If empty, the country in the app URL is used, else 'us'.", "items": { "type": "string" } }, "sort": { "title": "Sort reviews by", "enum": [ "recent", "helpful", "favorable", "critical" ], "type": "string", "description": "Most recent, most helpful (Apple's default), most favorable or most critical.", "default": "recent" }, "since": { "title": "Only reviews posted after", "type": "string", "description": "Date (YYYY-MM-DD). With 'Most recent' sorting, stops as soon as older reviews are reached — cheap way to get last week's reviews." }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at least this many stars (1–5).", "default": 1 }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at most this many stars. Set 2 to collect only negative reviews.", "default": 5 }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep only reviews whose title or text contains one of these words (e.g. crash, price, subscription, login).", "items": { "type": "string" } }, "includeInsights": { "title": "Review insights (complaints, praise, trend)", "type": "boolean", "description": "Add one summary row per app and country: rating distribution, monthly trend, developer reply rate, and the phrases that come up most in negative and positive reviews (e.g. \"crashes after update\", \"too expensive\"). Needs at least 10 reviews.", "default": false }, "includeDetails": { "title": "Include app details", "type": "boolean", "description": "Add one row per app and country with rating, rating count, version, release date, price, genre and developer.", "default": true }, "language": { "title": "Language override", "type": "string", "description": "Optional locale like en-GB or fr-FR. By default the main language of each storefront is used." }, "includeUserName": { "title": "Include reviewer nickname", "type": "boolean", "description": "Off by default for privacy. Only turn on if you have a legitimate reason to process reviewer nicknames.", "default": false }, "monitorMode": { "title": "Monitoring mode (new reviews only)", "type": "boolean", "description": "Only output reviews posted since the previous run with the same Monitor ID (the first run saves a baseline). Schedule daily for a new-reviews feed to Slack, email or a sheet.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Name of your watch list. Use a different ID for each independent list of apps.", "default": "default" }, "proxy": { "title": "Proxy", "type": "object", "description": "Optional. Apple rate-limits per IP; a proxy switches IP when blocked. Useful for very large jobs.", "default": { "useApifyProxy": 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 } } } } } } } } } }