{ "openapi": "3.0.1", "info": { "title": "App Store Reviews & App Summary (Multi-Country)", "description": "Get Apple App Store reviews and an app summary (rating, rating count, version, rating breakdown) for many apps across many countries in one run. Uses Apple's public RSS and lookup endpoints. No login, no proxy, no browser.", "version": "0.1", "x-build-id": "JwouqNNxKt0j8OggA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jiyue-dev~appstore-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jiyue-dev-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/jiyue-dev~appstore-reviews/runs": { "post": { "operationId": "runs-sync-jiyue-dev-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/jiyue-dev~appstore-reviews/run-sync": { "post": { "operationId": "run-sync-jiyue-dev-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", "minItems": 1, "maxItems": 100, "type": "array", "description": "App Store app IDs (e.g. 389801252) or app URLs (e.g. https://apps.apple.com/us/app/instagram/id389801252). One per line.", "items": { "type": "string" } }, "countries": { "title": "Countries", "maxItems": 60, "type": "array", "description": "Two-letter App Store country codes (ISO 3166-1 alpha-2), e.g. us, gb, de, jp. Each app is fetched once per country. Reviews are country-specific.", "default": [ "us" ], "items": { "type": "string" } }, "sortBy": { "title": "Review order", "enum": [ "mostrecent", "mosthelpful", "both" ], "type": "string", "description": "Apple returns at most 500 reviews per app, country and order. 'Both' merges most recent and most helpful (deduplicated) to get up to ~1,000.", "default": "mostrecent" }, "maxReviewsPerApp": { "title": "Max reviews per app and country", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Stop after this many reviews for each app × country. 0 = only the app summary, no reviews.", "default": 100 }, "since": { "title": "Only reviews since (date)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional. Keep only reviews updated on or after this date (YYYY-MM-DD). Useful for daily monitoring." }, "ratings": { "title": "Star ratings to keep", "type": "array", "description": "Optional. Keep only reviews with these star ratings, e.g. 1 and 2 to find complaints. Empty = all ratings.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional. Keep only reviews whose title or text contains at least one of these words (case-insensitive).", "items": { "type": "string" } }, "includeAppSummary": { "title": "Include app summary rows", "type": "boolean", "description": "Add one summary row per app × country: average rating, total rating count, current version, release date, and the version/star breakdown of the reviews collected in this run.", "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 } } } } } } } } } }