{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews API | $0.25/1K", "description": "Scrape app reviews from the Apple App Store and Google Play in one Actor. Paste IDs or store URLs, pick countries, star ratings and dates. Developer replies, app versions, helpful votes and a monitor mode that returns only new reviews. No reviewer names.", "version": "0.1", "x-build-id": "YqjMgfE2tU2IdgMMi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyrow~app-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyrow-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/steadyrow~app-reviews/runs": { "post": { "operationId": "runs-sync-steadyrow-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/steadyrow~app-reviews/run-sync": { "post": { "operationId": "run-sync-steadyrow-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", "type": "array", "description": "App IDs or store URLs. The store is detected automatically. App Store: numeric ID (284882215), \"id284882215\" or an apps.apple.com URL. Google Play: package name (com.spotify.music) or a play.google.com URL.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes (us, gb, de, jp, ...). App Store reviews are separate per country storefront. Google Play reviews are grouped by language, so countries sharing a language (us, gb, au) are fetched once. Default: us.", "default": [ "us" ], "items": { "type": "string" } }, "languages": { "title": "Languages (Google Play)", "type": "array", "description": "Google Play review languages (en, de, ja, pt-BR, ...). Leave empty to use the main language of each country. Ignored for the App Store, where reviews belong to the country storefront.", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "newest", "most_helpful" ], "type": "string", "description": "Newest first, or most helpful first. Monitor mode always uses newest.", "default": "newest" }, "maxReviewsPerApp": { "title": "Max reviews per app and country", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper limit of reviews returned for each app in each country (and each language on Google Play). The App Store public feed exposes up to ~500 reviews per country and sort order.", "default": 200 }, "ratings": { "title": "Star ratings", "type": "array", "description": "Only return reviews with these star ratings. Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "since": { "title": "Reviews since", "type": "string", "description": "Only reviews on or after this date. Absolute (2026-10-01) or relative (7 days, 2 weeks, 3 months)." }, "until": { "title": "Reviews until", "type": "string", "description": "Only reviews on or before this date. Absolute (2026-10-15) or relative (1 day)." }, "monitorMode": { "title": "Monitor mode (only new reviews)", "type": "boolean", "description": "Return only reviews that were not returned by a previous run with the same monitor name. The first run returns the latest reviews as a baseline. Ideal for scheduled runs, alerts and support dashboards.", "default": false }, "monitorStateName": { "title": "Monitor name", "type": "string", "description": "Name of the key-value store that remembers which reviews were already delivered. Use different names for independent monitors.", "default": "app-reviews-monitor" }, "includeAuthorHash": { "title": "Include anonymous author hash", "type": "boolean", "description": "Adds author_hash, a 12-character one-way hash of the reviewer's store account, so you can group reviews by the same author without any personal data. Reviewer names, profile links and avatars are never returned.", "default": false }, "deduplicate": { "title": "Deduplicate reviews", "type": "boolean", "description": "Return (and charge) each review only once per run, even if the same app is listed twice (e.g. as ID and URL).", "default": 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 } } } } } } } } } }