{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews Scraper", "description": "Scrape app reviews from the Apple App Store and Google Play in one run: stars, text, date, app version, developer replies. Monitor mode returns only new reviews since the last run. Filter by stars, keywords and date, across countries and languages. No login or API key.", "version": "0.0", "x-build-id": "MPNbmz7IlqhdTdJSY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cancap~app-reviews-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cancap-app-reviews-monitor", "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/cancap~app-reviews-monitor/runs": { "post": { "operationId": "runs-sync-cancap-app-reviews-monitor", "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/cancap~app-reviews-monitor/run-sync": { "post": { "operationId": "run-sync-cancap-app-reviews-monitor", "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": "One app per line. App Store: paste the app URL (https://apps.apple.com/us/app/name/id310633997) or just the numeric ID. Google Play: paste the app URL or the package name (com.spotify.music). You can mix both stores.", "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "type": "integer", "description": "Newest reviews first. The limit applies to each app in each country (App Store) or language (Google Play).", "default": 100 }, "appStoreCountries": { "title": "App Store countries", "type": "array", "description": "Two-letter country codes, e.g. us, gb, de, fr, jp. Apple shows different reviews in each country's store, up to the 500 most recent per country. Add countries to get more reviews.", "items": { "type": "string" } }, "googlePlayLanguages": { "title": "Google Play languages", "type": "array", "description": "Language codes, e.g. en, es, de, fr, pt-BR, ja. Google Play shows the reviews written in each language.", "items": { "type": "string" } }, "onlyNew": { "title": "Monitor mode: return only reviews that are new since the last run", "type": "boolean", "description": "The first run returns the latest reviews and remembers where it stopped. Every later run returns only new reviews (and reviews that users edited). Schedule the Actor hourly or daily to get a live feed of new reviews.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "New reviews are tracked separately for each monitor name. Use different names if you watch the same app in separate schedules.", "default": "default" }, "minRating": { "title": "Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only return reviews with at least this many stars (1-5).", "default": 1 }, "maxRating": { "title": "Maximum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only return reviews with at most this many stars (1-5). Set to 2 to get only negative reviews.", "default": 5 }, "keywords": { "title": "Keywords", "type": "array", "description": "Only return reviews whose title or text contains any of these words, e.g. crash, login, refund. Leave empty for all reviews.", "items": { "type": "string" } }, "maxAgeDays": { "title": "Only reviews from the last N days", "minimum": 1, "type": "integer", "description": "Skip reviews older than this many days. Leave empty for no date limit." }, "includeAuthor": { "title": "Include reviewer name", "type": "boolean", "description": "Adds the public display name of the reviewer. Turn off if you do not need it.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Requests go direct first and through Apify Proxy only when needed. The default works for most apps.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }