{ "openapi": "3.0.1", "info": { "title": "App Store Reviews Scraper", "description": "Scrape Apple App Store reviews for any app and country: star rating, title, text, date, app version and helpful votes. Filter by stars, date, keyword or app version; only new reviews for schedules. No login. $0.10 per 1,000 reviews.", "version": "0.1", "x-build-id": "2ObtcfVRlctmjJYnU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/locaihost~app-store-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-locaihost-app-store-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/locaihost~app-store-reviews/runs": { "post": { "operationId": "runs-sync-locaihost-app-store-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/locaihost~app-store-reviews/run-sync": { "post": { "operationId": "run-sync-locaihost-app-store-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", "properties": { "apps": { "title": "App Store apps", "type": "array", "description": "App Store links or numeric ids (https://apps.apple.com/us/app/duolingo-language-lessons/id570060128 or 570060128). Bundle ids (com.example.app) work too.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter App Store countries, such as us, gb, de, jp, in, br. Each country has its own reviews, read separately.", "default": [ "us" ], "items": { "type": "string" } }, "reviewSort": { "title": "Review order", "enum": [ "newest", "helpful" ], "type": "string", "description": "Newest first, or most helpful first.", "default": "newest" }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Per app and country. Apple's public review feed holds at most the 500 newest (or most helpful) reviews per app and country. Default 100.", "default": 100 }, "reviewRatings": { "title": "Only these star ratings", "type": "array", "description": "Leave empty for all ratings. Pick 1 and 2 to collect complaints only.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "reviewsSince": { "title": "Reviews published on or after", "type": "string", "description": "Optional. Only reviews from this date on, like 2026-09-01, or a period back from today like 30 days. With newest-first order the run stops reading an app at the first older review, so it reads only the pages it needs. Older reviews are not charged." }, "reviewKeywords": { "title": "Reviews mentioning", "type": "array", "description": "Optional. Only reviews whose title or text contains one of these words or phrases, ignoring case, e.g. crash, refund, subscription. Other reviews are left out and not charged.", "items": { "type": "string" } }, "appVersions": { "title": "App versions", "type": "array", "description": "Optional. Only reviews written on these app versions, as the store shows them. 5.2 matches 5.2 and 5.2.1. Reviews that show no version are left out. Not charged when left out.", "items": { "type": "string" } }, "includeReviewerNames": { "title": "Include reviewer display names", "type": "boolean", "description": "Off by default. On adds the public nickname the App Store shows. Emails, account ids and profile pictures are never collected.", "default": false }, "onlyNew": { "title": "Only new since the last run", "type": "boolean", "description": "Skip reviews this same input already returned in an earlier run. Turn on for scheduled review monitoring: you pay only for new reviews.", "default": false }, "maxItems": { "title": "Max rows", "minimum": 0, "type": "integer", "description": "Stop after this many reviews in total. 0 means no limit.", "default": 0 }, "mode": { "title": "What to get", "type": "string", "description": "Reviews, always, in this Actor.", "default": "reviews" } } }, "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 } } } } } } } } } }