{ "openapi": "3.0.1", "info": { "title": "App Reviews Scraper - App Store & Google Play + Reports", "description": "App Store and Google Play reviews in one run, plus a ready report per app: rating trend, rating by app version, top complaints and praise with quotes, developer reply rate, competitor comparison, new-review alerts and a shareable HTML report.", "version": "0.1", "x-build-id": "Y53VosOVu1HdIx8J5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/skydata~app-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-skydata-app-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/skydata~app-reviews-scraper/runs": { "post": { "operationId": "runs-sync-skydata-app-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/skydata~app-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-skydata-app-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": [ "apps" ], "properties": { "apps": { "title": "Apps", "type": "array", "description": "App Store links or IDs (id570060128), Google Play links or package names (com.duolingo), or app names (searched in both stores). One per line.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "2-letter country codes. App Store reviews are per country (Apple shows up to 500 newest reviews per country), so add more countries for more reviews. Google Play uses the first country.", "default": [ "us" ], "items": { "type": "string" } }, "googlePlayLanguage": { "title": "Google Play review language", "type": "string", "description": "Google Play shows reviews written in this language (en, es, de, ar ...).", "default": "en" }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Newest reviews first.", "default": 500 }, "days": { "title": "Only reviews from the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "0 = no date limit.", "default": 0 }, "includeReviews": { "title": "Include every review in the output", "type": "boolean", "description": "Turn off to get only the reports (cheaper).", "default": true }, "nameSearchStores": { "title": "Stores to search when you enter an app name", "type": "array", "description": "Only used for app names, not links.", "items": { "type": "string", "enum": [ "appstore", "googleplay" ], "enumTitles": [ "App Store", "Google Play" ] }, "default": [ "appstore", "googleplay" ] }, "monitorChanges": { "title": "Monitor changes (new reviews since last run)", "type": "boolean", "description": "Remember each app between runs and report new reviews, new negative reviews and rating changes. Schedule it (for example daily) to get alerts.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Keeps separate memories for different app lists.", "default": "default" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy (included in the price). Switches to residential automatically if a store keeps refusing.", "default": { "useApifyProxy": true } }, "fallbackToResidential": { "title": "Switch to residential proxy if blocked", "type": "boolean", "description": "Included in the price.", "default": true }, "pacingMs": { "title": "Pause between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Average pause between requests.", "default": 400 }, "maxAttempts": { "title": "Attempts per request", "minimum": 1, "maximum": 12, "type": "integer", "description": "Retries with a new IP when a store refuses.", "default": 6 } } }, "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 } } } } } } } } } }