{ "openapi": "3.0.1", "info": { "title": "App Store Reviews Scraper — Any App, Any Country | $0.25/1K", "description": "Scrape Apple App Store reviews for any app in any country storefront: ratings, titles, text, app versions and helpful votes. Filter by stars and date, sort newest or most helpful, and use monitor mode to get only new reviews. Official RSS feed, no proxy, no reviewer names.", "version": "0.1", "x-build-id": "leZO4XBobkKWDpbCk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyrow~appstore-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyrow-appstore-reviews", "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/steadyrow~appstore-reviews/runs": { "post": { "operationId": "runs-sync-steadyrow-appstore-reviews", "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/steadyrow~appstore-reviews/run-sync": { "post": { "operationId": "run-sync-steadyrow-appstore-reviews", "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 apps, one per line: a numeric ID (324684580), `id324684580`, or an apps.apple.com URL. Google Play packages are skipped (use the Google Play Reviews Scraper for those).", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes (us, gb, de, jp, ...). Every App Store country storefront has its own reviews, so each country is fetched separately. Default: us.", "default": [ "us" ], "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "newest", "most_helpful" ], "type": "string", "description": "Newest first, or most helpful first. Monitor mode always uses newest.", "default": "newest" }, "maxReviewsPerApp": { "title": "Max reviews per app and country", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper limit of reviews for each app in each country. Apple's public feed exposes at most ~500 reviews per country and sort order; to get more, add countries or run both sort orders.", "default": 200 }, "ratings": { "title": "Star ratings", "type": "array", "description": "Only return reviews with these star ratings. Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "since": { "title": "Reviews since", "type": "string", "description": "Only reviews on or after this date. Absolute (2026-10-01) or relative (7 days, 2 weeks, 3 months)." }, "until": { "title": "Reviews until", "type": "string", "description": "Only reviews on or before this date. Absolute (2026-10-15) or relative (1 day)." }, "monitorMode": { "title": "Monitor mode (only new reviews)", "type": "boolean", "description": "Return only reviews that were not returned by a previous run with the same monitor name. The first run returns the latest reviews as a baseline. Ideal for scheduled runs, alerts and support dashboards.", "default": false }, "monitorStateName": { "title": "Monitor name", "type": "string", "description": "Name of the key-value store that remembers which reviews were already delivered. Use different names for independent monitors.", "default": "appstore-reviews-monitor" }, "includeAuthorHash": { "title": "Include anonymous author hash", "type": "boolean", "description": "Adds author_hash, a 12-character one-way hash of the reviewer's store account, so you can group reviews by the same author without any personal data. Reviewer names, profile links and avatars are never returned.", "default": false }, "deduplicate": { "title": "Deduplicate reviews", "type": "boolean", "description": "Return (and charge) each review only once per run, even if the same app is listed twice (e.g. as ID and URL).", "default": 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 } } } } } } } } } }