{ "openapi": "3.0.1", "info": { "title": "App Store Review Insights – Topics & Version Regressions", "description": "Pull recent iOS App Store reviews for any app and country, tagged by topic, plus a per-app report: rating by version with regression flags, complaint topics, top negative phrases and quotes. Deterministic rules, no AI.", "version": "0.1", "x-build-id": "jJkxg4RI2JjybVU4f" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/skuang~app-store-review-insights/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-skuang-app-store-review-insights", "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/skuang~app-store-review-insights/runs": { "post": { "operationId": "runs-sync-skuang-app-store-review-insights", "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/skuang~app-store-review-insights/run-sync": { "post": { "operationId": "run-sync-skuang-app-store-review-insights", "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": 50, "type": "array", "description": "Up to 50 App Store URLs (for example https://apps.apple.com/us/app/instagram/id389801252) or numeric app IDs (389801252). Entries that are neither are reported as failed in the OUTPUT record; the rest of the run continues.", "default": [ "310633997" ], "items": { "type": "string" } }, "countries": { "title": "Countries", "minItems": 1, "maxItems": 30, "type": "array", "description": "Up to 30 two-letter App Store country codes (us, gb, de, jp, ...). Each app is fetched separately in each country. \"uk\" is accepted as an alias for \"gb\". Codes Apple does not recognize are reported as failed for that app and country; the rest of the run continues.", "default": [ "us" ], "items": { "type": "string" } }, "maxReviewsPerCountry": { "title": "Max reviews per app and country", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop after this many reviews per app and country. Apple's feed returns at most 500 of the most recent reviews (10 pages of 50).", "default": 500 }, "sinceDate": { "title": "Only reviews since", "type": "string", "description": "Optional. Keep only reviews posted on or after this date (YYYY-MM-DD, midnight UTC) and stop paging once older reviews appear. Leave empty to take the most recent reviews up to the limit above." }, "outputMode": { "title": "Output", "enum": [ "reviews_and_insights", "insights_only", "reviews_only" ], "type": "string", "description": "What to save to the dataset. The insights report is always computed from every review fetched, even when individual reviews are not saved.", "default": "reviews_and_insights" }, "includeAuthorNames": { "title": "Include reviewer nicknames", "type": "boolean", "description": "Add the reviewer's App Store nickname to each review item. Off by default to keep personal data out of your dataset.", "default": 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 } } } } } } } } } }