{ "openapi": "3.0.1", "info": { "title": "App Store Reviews Scraper · All Countries, Deduped · No Login", "description": "Apple App Store reviews scraper. Pulls reviews from every country storefront in one run instead of the 500 one country allows, deduplicated by review ID. Input by App Store URL, app ID or search term. Filter by stars, date and app version. No login required.", "version": "0.1", "x-build-id": "XzMx0IgGeVN8z81Oq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thequietstack~app-store-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thequietstack-app-store-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/thequietstack~app-store-reviews/runs": { "post": { "operationId": "runs-sync-thequietstack-app-store-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/thequietstack~app-store-reviews/run-sync": { "post": { "operationId": "run-sync-thequietstack-app-store-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", "properties": { "apps": { "title": "Apps (URL or ID)", "type": "array", "description": "App Store URLs (apps.apple.com/.../id389801252) or bare numeric app IDs.", "items": { "type": "string" } }, "searchTerms": { "title": "Or: search terms", "type": "array", "description": "App names or keywords. Resolved with Apple's official search in the first selected country.", "items": { "type": "string" } }, "appsPerSearchTerm": { "title": "Apps per search term", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many top search results to scrape for each search term.", "default": 1 }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes (us, gb, de, fr, jp ...). Apple returns at most 500 reviews per country, so more countries means more reviews.", "default": [ "us", "gb", "ca", "au" ], "items": { "type": "string" } }, "allCountries": { "title": "All countries (~175 storefronts)", "type": "boolean", "description": "Ignore the list above and scrape every App Store storefront. Countries without reviews cost nothing.", "default": false }, "sortBy": { "title": "Sort", "enum": [ "mostRecent", "mostHelpful" ], "type": "string", "description": "Most recent is required for an efficient date filter.", "default": "mostRecent" }, "ratings": { "title": "Only these star ratings", "type": "array", "description": "e.g. [1, 2] for complaints only. Empty = all ratings. Filtered-out reviews are not charged." }, "sinceDate": { "title": "Only reviews after (YYYY-MM-DD)", "type": "string", "description": "Paging stops as soon as reviews get older than this date." }, "untilDate": { "title": "Only reviews before (YYYY-MM-DD)", "type": "string", "description": "Optional upper bound for the review date." }, "versions": { "title": "Only these app versions", "type": "array", "description": "Exact version (\"448.0.0\") or a prefix (\"448\" matches 448.x). Empty = all versions.", "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "type": "integer", "description": "Stop an app after this many reviews. Empty = no per-app limit." }, "maxReviews": { "title": "Hard limit: total reviews in this run", "minimum": 1, "type": "integer", "description": "The run stops cleanly at this number. You are never charged for more reviews than this.", "default": 5000 }, "concurrency": { "title": "Parallel countries", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many countries are fetched at the same time.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apple throttles single IPs on large runs (HTTP 403). The default Apify datacenter proxy rotates the IP on every retry.", "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 } } } } } } } } } }