{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews Scraper - iOS + Android", "description": "Scrape app reviews from the Apple App Store and Google Play. Rating, title, text, date, version, developer reply. Any country, newest or most critical first. No login, no API key, no residential proxy.", "version": "0.1", "x-build-id": "eeun9T8KefXaiy8uh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/teamsasuke~app-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-teamsasuke-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/teamsasuke~app-reviews-scraper/runs": { "post": { "operationId": "runs-sync-teamsasuke-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/teamsasuke~app-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-teamsasuke-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 or Google Play links, or bare IDs, one per line. App Store: a link such as https://apps.apple.com/us/app/whatsapp-messenger/id310633997 or just the number 310633997. Google Play: a link such as https://play.google.com/store/apps/details?id=com.whatsapp or just the package name com.whatsapp. Mix both stores freely.", "default": [ "https://apps.apple.com/us/app/whatsapp-messenger/id310633997", "com.whatsapp" ], "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many reviews for each app in each country. The App Store serves 20 reviews per request and Google Play a few hundred, so a large number simply takes longer. There is no hard ceiling: 10,000 reviews from one App Store listing works.", "default": 500 }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter storefront codes such as us, gb, de, in, br, jp. Each app is scraped once per country. A country inside an App Store link (apps.apple.com/gb/...) overrides this list for that app.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code such as en, de, pt, ja. Google Play keeps reviews per language, so this decides which Google Play reviews you get. Reviews come back in whatever language they were written.", "default": "en" }, "sort": { "title": "Sort order", "enum": [ "newest", "most_helpful", "highest_rating", "lowest_rating" ], "type": "string", "description": "Which reviews come first. 'Newest first' is the right choice for monitoring and for the 'Only reviews since' filter. 'Lowest rating first' is the fastest way to collect complaints.", "default": "newest" }, "ratings": { "title": "Only these star ratings", "type": "array", "description": "Leave empty for all ratings. Pick 1 and 2 to collect only critical reviews, or 5 for testimonials.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] }, "default": [] }, "reviewsSince": { "title": "Only reviews since", "type": "string", "description": "A date such as 2026-01-01. Older reviews are skipped. With 'Newest first' the scraper stops the moment it reaches older reviews, which keeps runs short and cheap.", "default": "" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apple rate-limits its review pages per address, so App Store requests go through Apify's shared datacenter proxy by default and move to a fresh address whenever a limit is hit. That proxy is included in every Apify plan at no extra charge. Residential proxies are never needed. Google Play is read directly unless you supply your own proxy URLs.", "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 } } } } } } } } } }