{ "openapi": "3.0.1", "info": { "title": "App Reviews: App Store + Google Play", "description": "App Store and Google Play reviews scraper for feedback analysis. Export review text, ratings, dates and developer replies as JSON, with optional app profile rows.", "version": "1.0", "x-build-id": "nepOO1vojVUDtJYQE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/grit-77~app-reviews-app-store-google-play/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-grit-77-app-reviews-app-store-google-play", "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/grit-77~app-reviews-app-store-google-play/runs": { "post": { "operationId": "runs-sync-grit-77-app-reviews-app-store-google-play", "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/grit-77~app-reviews-app-store-google-play/run-sync": { "post": { "operationId": "run-sync-grit-77-app-reviews-app-store-google-play", "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 (App Store and Google Play, mixed)", "type": "array", "description": "App Store URLs or numeric ids (https://apps.apple.com/us/app/spotify/id324684580, 324684580) and Google Play URLs or package names (https://play.google.com/store/apps/details?id=com.spotify.music, com.spotify.music). The store is detected automatically; prefix with `ios:` or `android:` to force it.", "items": { "type": "string" } }, "countries": { "title": "Countries (storefronts)", "type": "array", "description": "2-letter country codes, e.g. us, gb, de. App Store reviews are per storefront. Google Play shares most reviews between countries of the same language, so repeats are removed (kept under the first country). If left empty, the country in an app URL is used, otherwise `us`.", "default": [ "us" ], "items": { "type": "string" } }, "languages": { "title": "Languages", "type": "array", "description": "Language codes, e.g. en, de, pt-BR. Google Play returns reviews per language, so each one is a separate pass. The App Store review set does not depend on language, so only the first one is used there.", "default": [ "en" ], "items": { "type": "string" } }, "sort": { "title": "Sort", "enum": [ "newest", "relevant" ], "type": "string", "description": "`newest` returns the latest reviews first (best for monitoring and with a start date). `relevant` returns the store's own ranking (Apple: most helpful, Google Play: most relevant).", "default": "newest" }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep reviews with at least this many stars (1-5).", "default": 1 }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep reviews with at most this many stars (1-5). Use minRating 1 and maxRating 2 to collect complaints.", "default": 5 }, "sinceDate": { "title": "Only reviews since", "type": "string", "description": "ISO date or datetime, e.g. 2026-09-01. Reviews older than this are dropped; with sort `newest` reading stops there, which keeps runs short." }, "maxReviewsPerApp": { "title": "Max reviews per app and country", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Upper bound of reviews kept for each app in each country/language pass, after filters. 0 returns only app info.", "default": 200 }, "maxItems": { "title": "Max items (whole run)", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Hard cap on all charged rows (reviews plus app-info rows). Error rows are free and not counted.", "default": 1000 }, "includeAppInfo": { "title": "Include app info rows", "type": "boolean", "description": "Add one `type: app` row per app and country with average rating, ratings count, installs (Google Play), version, last update and developer. Charged as its own event.", "default": true }, "maxConcurrency": { "title": "Max concurrent apps", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many apps are read in parallel. Keep low; both stores rate-limit.", "default": 4 }, "appleSource": { "title": "App Store source", "enum": [ "auto", "web", "rss" ], "type": "string", "description": "`auto` reads the public web reviews endpoint of apps.apple.com and falls back to Apple's customer-reviews RSS feed. `web` or `rss` force one. RSS is limited to 500 reviews and often returns empty pages.", "default": "auto" } } }, "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 } } } } } } } } } }