{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews Scraper API | $0.10/1K Reviews", "description": "Scrape Apple App Store and Google Play reviews in one run, with one identical output schema for both stores. $0.10 per 1,000 reviews, and you only pay for reviews you actually receive. Ratings, review text, dates, app versions and developer replies. Export to JSON, CSV or Excel. No API key.", "version": "0.1", "x-build-id": "id7GkuoPPHRuwmchC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/opaled_hurricane~unified-app-store-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-opaled_hurricane-unified-app-store-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/opaled_hurricane~unified-app-store-reviews-scraper/runs": { "post": { "operationId": "runs-sync-opaled_hurricane-unified-app-store-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/opaled_hurricane~unified-app-store-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-opaled_hurricane-unified-app-store-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", "properties": { "appleAppIds": { "title": "Apple App Store app IDs", "type": "array", "description": "Numeric App Store IDs. Find one in any App Store URL: apps.apple.com/us/app/whatsapp-messenger/id310633997 -> 310633997", "items": { "type": "string" } }, "googlePlayPackages": { "title": "Google Play package names", "type": "array", "description": "Android package names. Find one in any Play Store URL: play.google.com/store/apps/details?id=com.whatsapp -> com.whatsapp", "items": { "type": "string" } }, "country": { "title": "Country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter storefront. Used only when 'countries' is empty. Apple returns a DIFFERENT set of reviews per storefront and caps each at 500.", "default": "us" }, "countries": { "title": "Storefronts to sweep", "type": "array", "description": "Two-letter codes, e.g. us, gb, de, jp. Apple caps reviews at 500 per app PER STOREFRONT and each one holds different reviews, so sweeping several is the only way past 500. Results are deduped by review id across storefronts, so you are never billed twice for the same review. Raise maxReviewsPerApp to match — the sweep stops as soon as that budget is filled. Overrides 'country'. Max 40.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code, e.g. en, de, ja, es. This is what determines WHICH reviews Google Play returns - each language has its own separate set. It does not change which Apple reviews you get (use country for that).", "default": "en" }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Total reviews per app ACROSS all storefronts. Billing is per review, so this is your spend cap. Apple gives at most 500 per storefront; a 4-storefront sweep can return ~2000.", "default": 100 }, "sortBy": { "title": "Sort by", "enum": [ "newest", "rating", "helpfulness" ], "type": "string", "description": "Review ordering. Note: the Apple feed does not support sorting by rating; Apple apps fall back to newest (Google Play honours it).", "default": "newest" } } }, "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 } } } } } } } } } }