{ "openapi": "3.0.1", "info": { "title": "App Store Reviews Scraper — Unlimited | $5/1K", "description": "Apple App Store reviews past the 500-per-country cap — sweeps every major storefront for tens of thousands per app. Each review carries the app version, so complaints map to releases. Plus app details, prices, search and charts. For ASO and competitor research.", "version": "0.1", "x-build-id": "EyhuZct5yFpmlzKGZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datawell~appstore-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datawell-appstore-reviews-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/datawell~appstore-reviews-scraper/runs": { "post": { "operationId": "runs-sync-datawell-appstore-reviews-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/datawell~appstore-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-datawell-appstore-reviews-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": [ "mode" ], "properties": { "mode": { "title": "What to scrape", "enum": [ "reviews", "apps", "search", "charts" ], "type": "string", "description": "Pick what you want to collect. The fields below apply depending on this choice.", "default": "reviews" }, "appIds": { "title": "Apps", "type": "array", "description": "App IDs (310633997) or App Store URLs (https://apps.apple.com/us/app/whatsapp/id310633997). Used in the review and app modes.", "items": { "type": "string" } }, "searchQuery": { "title": "Search term", "type": "string", "description": "What to search for in the App Store, e.g. 'habit tracker'. Used in search mode." }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Total number of records to collect. With several apps, the budget is split evenly between them.", "default": 100 }, "countries": { "title": "Storefronts", "type": "array", "description": "Two-letter country codes, e.g. us, gb, de. Apple caps reviews at 500 per storefront — add more countries to get past that.", "items": { "type": "string" } }, "allCountries": { "title": "Use all major storefronts", "type": "boolean", "description": "Sweeps the 20 largest storefronts instead of the list above. Each one holds up to 500 more reviews, so this is how you get tens of thousands from a single app.", "default": false }, "sortBy": { "title": "Sort order", "enum": [ "mostRecent", "mostHelpful" ], "type": "string", "description": "Newest reviews first, or the ones other users found most helpful.", "default": "mostRecent" }, "includeAppName": { "title": "Add the app name to each review", "type": "boolean", "description": "Costs one extra request per app, but makes multi-app exports readable.", "default": true }, "chartType": { "title": "Which chart", "enum": [ "topfreeapplications", "toppaidapplications", "topgrossingapplications", "newapplications", "newfreeapplications", "newpaidapplications" ], "type": "string", "description": "Which ranking to fetch. Used in charts mode.", "default": "topfreeapplications" }, "genreId": { "title": "Category ID", "type": "string", "description": "Restrict charts to a category, e.g. 6014 for Games, 6017 for Education, 6007 for Productivity. Leave empty for all." }, "requestDelaySeconds": { "title": "Delay between requests", "minimum": 0, "maximum": 10, "type": "integer", "description": "Seconds to wait between calls. Raise this for very large runs.", "default": 0 } } }, "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 } } }, "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 } } } } } } } } } }