{ "openapi": "3.0.1", "info": { "title": "App Store Review Scraper: iOS Reviews by Country", "description": "Scrape Apple App Store reviews for any iOS or iPadOS app across up to 175 country storefronts. Returns rating, title, body, author, app version and helpful votes per review, plus an app profile row with rating counts, price, genres and release notes. Accepts app IDs, bundle IDs, URLs or names.", "version": "0.1", "x-build-id": "YfKfpQLvaYe1Nxd6F" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiorasolutions~app-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiorasolutions-app-review-scraper", "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/axiorasolutions~app-review-scraper/runs": { "post": { "operationId": "runs-sync-axiorasolutions-app-review-scraper", "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/axiorasolutions~app-review-scraper/run-sync": { "post": { "operationId": "run-sync-axiorasolutions-app-review-scraper", "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, "uniqueItems": true, "type": "array", "description": "One app per entry. All of these work: a numeric App Store ID (310633997), a full App Store URL, a bundle ID (com.whatsapp.WhatsApp), or name:Search Term to resolve the top match by name.", "items": { "type": "string" } }, "countries": { "title": "Country storefronts", "type": "array", "description": "Two-letter App Store country codes. Reviews are stored per storefront, so add every market you care about. Common: us, gb, de, fr, es, it, br, jp, kr, in, ca, au, nl, se, mx.", "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Total review cap for each app across every country. This is the number that controls your bill.", "default": 200 }, "maxReviewsPerCountry": { "title": "Max reviews per country", "minimum": 10, "maximum": 500, "type": "integer", "description": "Per-storefront cap. Apple publishes at most 500 reviews per app per country through its public feed, so values above 500 have no effect.", "default": 500 }, "sortBy": { "title": "Sort order", "enum": [ "mostRecent", "mostHelpful" ], "type": "string", "description": "mostRecent walks the newest reviews first and is what you want for monitoring. mostHelpful returns the reviews Apple surfaces on the store page.", "default": "mostRecent" }, "includeAppProfile": { "title": "Include an app profile row", "type": "boolean", "description": "Add one row per app and country with name, developer, price, genres, average rating, total rating count, current version, release notes and screenshot URLs.", "default": true }, "minRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews at or above this many stars. Set to 1 to keep everything.", "default": 1 }, "maxRating": { "title": "Maximum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews at or below this many stars. Set both to 1 to collect only one-star complaints.", "default": 5 }, "reviewedAfter": { "title": "Reviewed after", "type": "string", "description": "Keep only reviews written on or after this date. Accepts 2026-01-31 or a relative value such as 30 days." }, "keywords": { "title": "Review keywords", "type": "array", "description": "Keep only reviews whose title or body contains one of these words, case-insensitive. Useful for tracking a specific feature, bug or competitor mention.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Apple's public review feed normally answers direct requests, so leave this off unless you are collecting very large volumes and start seeing rate limiting.", "default": { "useApifyProxy": 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 } } } } } } } } } }