{ "openapi": "3.0.1", "info": { "title": "Apple App Store Reviews Scraper & API", "description": "Extract public Apple App Store reviews in structured form for ASO, sentiment analysis, product research, customer support, and competitor monitoring. Includes ratings, review text, dates, app versions, pagination, and reliable batch processing.", "version": "0.1", "x-build-id": "hZCkRJEYgEvqEuSh2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zenomastro~apple-app-store-reviews-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zenomastro-apple-app-store-reviews-pro", "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/zenomastro~apple-app-store-reviews-pro/runs": { "post": { "operationId": "runs-sync-zenomastro-apple-app-store-reviews-pro", "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/zenomastro~apple-app-store-reviews-pro/run-sync": { "post": { "operationId": "run-sync-zenomastro-apple-app-store-reviews-pro", "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", "minItems": 1, "maxItems": 100, "type": "array", "description": "Numeric App Store IDs, apps.apple.com URLs, or bundle IDs. Maximum 100 apps.", "default": [ "310633997" ], "items": { "type": "string" } }, "countries": { "title": "App Store countries", "minItems": 1, "maxItems": 20, "type": "array", "description": "Two-letter storefront codes such as us, gb, it, de, fr, jp. Maximum 20 per run.", "default": [ "us" ], "items": { "type": "string" } }, "sortBy": { "title": "Sort order", "enum": [ "mostrecent", "mosthelpful" ], "type": "string", "description": "Apple review feed sort order.", "default": "mostrecent" }, "maxReviewsPerAppCountry": { "title": "Max reviews per app/country", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum reviews kept for each app x storefront. Apple's public feed exposes at most about 500.", "default": 200 }, "maxTotalReviews": { "title": "Maximum total reviews", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Hard spend/runtime cap across the whole run.", "default": 5000 }, "minRating": { "title": "Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep reviews with at least this many stars. Filtering happens before billing.", "default": 1 }, "maxRating": { "title": "Maximum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep reviews with no more than this many stars. Filtering happens before billing.", "default": 5 }, "minHelpfulVotes": { "title": "Minimum helpful score", "minimum": 0, "type": "integer", "description": "Minimum Apple voteSum/helpful score. Set 0 to disable.", "default": 0 }, "containsText": { "title": "Review contains", "type": "string", "description": "Optional case-insensitive text filter applied to title + review body before billing.", "default": "" }, "reviewedAfter": { "title": "Reviewed after", "type": "string", "description": "Optional ISO date/time lower bound, e.g. 2026-01-01.", "default": "" }, "reviewedBefore": { "title": "Reviewed before", "type": "string", "description": "Optional ISO date/time upper bound, e.g. 2026-12-31.", "default": "" }, "includeAppMetadata": { "title": "Include app metadata", "type": "boolean", "description": "Attach app title, developer, category, current version, aggregate rating/count, icon and App Store URL to each review.", "default": true }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 5, "maximum": 60, "type": "integer", "description": "Maximum seconds for each Apple Lookup/RSS HTTP request.", "default": 20 }, "pageRetries": { "title": "Page retries", "minimum": 0, "maximum": 6, "type": "integer", "description": "Retries empty/transient RSS pages with bounded backoff before treating the page as unavailable.", "default": 3 } } }, "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 } } } } } } } } } }