{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews with daily tracking", "description": "Customer reviews of any iOS or Android app as clean JSON: rating, title, text excerpt, version, date and developer reply, with country, language, rating and date filters. Schedule it daily with 'Only new reviews' on. Reads Apple's and Google Play's public product pages, no logins.", "version": "0.1", "x-build-id": "qY4H9OvrJhKQ31d5W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataforge-tools~app-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataforge-tools-app-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/dataforge-tools~app-reviews/runs": { "post": { "operationId": "runs-sync-dataforge-tools-app-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/dataforge-tools~app-reviews/run-sync": { "post": { "operationId": "run-sync-dataforge-tools-app-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 (store URLs, appstore: or play:)", "type": "array", "description": "One entry per app. Accepts App Store URLs (https://apps.apple.com/us/app/whatsapp-messenger/id310633997), Google Play URLs (https://play.google.com/store/apps/details?id=com.whatsapp), the short forms 'appstore:310633997', 'appstore:net.whatsapp.WhatsApp' (bundle id) and 'play:com.whatsapp', a bare numeric App Store id, or a bare package name.", "default": [ "https://apps.apple.com/us/app/whatsapp-messenger/id310633997", "https://play.google.com/store/apps/details?id=com.whatsapp" ], "items": { "type": "string" } }, "countries": { "title": "Countries (App Store storefronts)", "type": "array", "description": "Two-letter country codes, e.g. us, gb, de, in, br. The App Store keeps separate reviews per storefront, so each country is fetched separately. For Google Play only the first country is sent as the store region. Clear the list to use each App Store URL's own storefront.", "default": [ "us" ], "items": { "type": "string" } }, "languages": { "title": "Languages (Google Play)", "type": "array", "description": "Language tags for Google Play reviews, e.g. en, de, pt-br, hi. Google Play reviews are fetched per language. App Store reviews are not filtered by language (Apple's page does not say which language a review is in).", "default": [ "en" ], "items": { "type": "string" } }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at least this many stars (1-5).", "default": 1 }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at most this many stars (1-5). Set minimum = maximum to get a single star value, e.g. only 1-star reviews.", "default": 5 }, "postedWithinDays": { "title": "Posted within the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Keep only reviews posted within this many days. Leave empty for any date." }, "onlyNew": { "title": "Only new reviews (change tracking)", "type": "boolean", "description": "Output only reviews that were not seen in previous runs with the same apps, countries, languages and filters. Ideal for a daily schedule: the first run outputs everything, later runs only what is new. History is kept in a named key-value store. Every record carries changeStatus ('new' or 'existing') and firstSeenAt either way.", "default": false }, "maxReviewsPerApp": { "title": "Max reviews per app and feed", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper limit of matching reviews per app and country (App Store) or language (Google Play). Public product pages contain a limited featured sample, with no paging or newest-first guarantee.", "default": 200 } } }, "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 } } } } } } } } } }