{ "openapi": "3.0.1", "info": { "title": "App Store Reviews & Ratings Scraper — All 174 Countries", "description": "Get Apple App Store reviews and star ratings for any iPhone, iPad or Mac app from every country storefront in one run. Filter by stars, date or keyword, track rating by country, and monitor only new reviews on a schedule. No reviewer names, no login.", "version": "1.0", "x-build-id": "e3LOc54bNT0iVD4nv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mzansi-dataworks~app-store-reviews-all-countries/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mzansi-dataworks-app-store-reviews-all-countries", "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/mzansi-dataworks~app-store-reviews-all-countries/runs": { "post": { "operationId": "runs-sync-mzansi-dataworks-app-store-reviews-all-countries", "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/mzansi-dataworks~app-store-reviews-all-countries/run-sync": { "post": { "operationId": "run-sync-mzansi-dataworks-app-store-reviews-all-countries", "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", "type": "array", "description": "App Store URLs (https://apps.apple.com/us/app/.../id310633997), numeric app IDs (310633997) or bundle IDs (net.whatsapp.WhatsApp).", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter storefront codes such as us, gb, de, za. Use 'top' for the 20 biggest storefronts (default) or 'all' for all 174.", "items": { "type": "string" } }, "maxReviewsPerCountry": { "title": "Max reviews per country", "minimum": 1, "maximum": 500, "type": "integer", "description": "Apple publishes up to 500 reviews per country and sort order.", "default": 100 }, "sortBy": { "title": "Sort", "enum": [ "mostrecent", "mosthelpful" ], "type": "string", "description": "Most recent reviews, or the reviews Apple ranks as most helpful.", "default": "mostrecent" }, "reviewsSince": { "title": "Only reviews since", "type": "string", "description": "Keep reviews written on or after this date (YYYY-MM-DD)." }, "minRating": { "title": "Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "For example 1 with maximum 2 to collect only complaints.", "default": 1 }, "maxRating": { "title": "Maximum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep reviews with at most this many stars.", "default": 5 }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep reviews whose title or text contains any of these words, e.g. crash, login, subscription.", "items": { "type": "string" } }, "includeAppDetails": { "title": "Include rating snapshot per country", "type": "boolean", "description": "Adds one row per app and country with the average rating, rating count, current version and price.", "default": true }, "onlyNew": { "title": "Only new since my last run", "type": "boolean", "description": "Remembers reviews from earlier runs (in a named key-value store on your account) and outputs only new ones. Use with a schedule to monitor reviews. Repeat reviews are not charged.", "default": false }, "stateKey": { "title": "Monitor name (with 'Only new')", "type": "string", "description": "Use a different name for each monitor so their memories don't mix." }, "maxItems": { "title": "Max reviews in total", "minimum": 1, "type": "integer", "description": "Stop after this many reviews across all apps and countries.", "default": 5000 } } }, "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 } } } } } } } } } }