{ "openapi": "3.0.1", "info": { "title": "App Store Reviews Scraper — iOS app reviews by app and country", "description": "Public reviews of any iOS app from Apple's App Store: reviewer, rating, title, text, date and the app's own rating and review count, per country, newest or most helpful first. Paste an app link, numeric ID or name. No login, no API key, pay per review, MCP-ready.", "version": "0.1", "x-build-id": "5WDjNPWYBuNF7ZhDH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/inovaflow~app-store-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-inovaflow-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/inovaflow~app-store-reviews-scraper/runs": { "post": { "operationId": "runs-sync-inovaflow-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/inovaflow~app-store-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-inovaflow-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", "minItems": 1, "maxItems": 500, "type": "array", "description": "One per line: `https://apps.apple.com/us/app/slack/id618783545`, `618783545`, or `Slack`.", "items": { "type": "string" } }, "countries": { "title": "Storefronts (countries)", "maxItems": 50, "type": "array", "description": "Two-letter country codes. Reviews live per storefront: `us` has the US reviews, `gb` the UK ones, and so on. One row set per app per country.", "default": [ "us" ], "items": { "type": "string" } }, "newestFirst": { "title": "Deliver newest first", "type": "boolean", "description": "Apple's feed comes in its own \"most helpful\" order and offers no date sort to the public. On, each app's delivered rows are sorted by date, newest first (the feed position is kept on every row). Off keeps Apple's order.", "default": true }, "maxReviewsPerApp": { "title": "Maximum reviews per app and storefront", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stops after this many delivered reviews for each app in each storefront. Also caps what you pay. Without filters that is the first N of Apple's feed; with a star or date filter the feed is read further (see the page budget) until N matching reviews are found.", "default": 100 }, "publishedAfter": { "title": "Only reviews published on or after", "type": "string", "description": "A date, `YYYY-MM-DD`. Keeps only reviews published on or after it. The feed is not in date order, so the Actor reads further pages (up to the page budget) to fill the maximum." }, "minRating": { "title": "Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews rated at least this many stars.", "default": 1 }, "maxRating": { "title": "Maximum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews rated at most this many stars. `2` with a minimum of `1` gives you the complaints.", "default": 5 }, "maxPagesPerApp": { "title": "Page budget when filtering", "minimum": 1, "maximum": 2500, "type": "integer", "description": "Apple's feed is in its own order, so with a star or date filter the Actor keeps reading pages (20 reviews each) until the maximum is filled with matching reviews — up to this many pages. 15 pages = 300 reviews read.", "default": 15 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many app/storefront pairs are read at the same time. Apple rate-limits each IP, so more parallelism means more proxy sessions, not faster pages.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apple answers a plain IP but throttles it after a few pages. The default Apify datacenter proxy rotates sessions on every throttle; residential is used automatically when the datacenter pool is throttled too.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }