{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews Scraper (iOS + Android)", "description": "Scrape App Store and Google Play reviews in one run with one unified output. Paste app URLs, IDs, package names or app names. Filter by stars, date and keyword. Multi-country reviews, developer replies, ratings, installs and complaint keywords per app. No login or API key. $0.40 per 1,000 reviews.", "version": "1.0", "x-build-id": "1X1EBihGPnlrTbPtn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/classier_wholemeal~app-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-classier_wholemeal-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/classier_wholemeal~app-reviews-scraper/runs": { "post": { "operationId": "runs-sync-classier_wholemeal-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/classier_wholemeal~app-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-classier_wholemeal-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", "properties": { "apps": { "title": "Apps (URLs, IDs or package names)", "type": "array", "description": "One per line. Accepted formats: App Store URL (https://apps.apple.com/us/app/spotify/id324684580), numeric Apple ID (324684580), Google Play URL (https://play.google.com/store/apps/details?id=com.spotify.music), or package name (com.spotify.music). You can also add a prefix to force the store, e.g. appstore:324684580 or play:com.duolingo.", "items": { "type": "string" } }, "appNames": { "title": "App names (search)", "type": "array", "description": "Don't have the IDs? Type app names such as Notion or Duolingo. The top match on each store chosen below is scraped.", "items": { "type": "string" } }, "searchStores": { "title": "Stores to search app names in", "type": "array", "description": "Only used for app names.", "items": { "type": "string", "enum": [ "appstore", "googleplay" ], "enumTitles": [ "Apple App Store", "Google Play" ] }, "default": [ "appstore", "googleplay" ] }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes (us, gb, de, fr, in, br, jp...). Reviews are scraped separately for each country, and each review row includes its country.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Language (Google Play)", "type": "string", "description": "Two-letter language code for Google Play reviews (en, de, es...). App Store reviews come in the country's language.", "default": "en" }, "sort": { "title": "Sort", "enum": [ "newest", "helpful", "both" ], "type": "string", "description": "Newest is best for monitoring. Both gives more unique reviews for App Store apps, which return at most 500 per sort per country.", "default": "newest" }, "maxReviewsPerApp": { "title": "Max reviews per app per country", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The limit applies after filters. Apple limits public reviews to about 500 per sort order per country. Google Play has no practical limit.", "default": 200 }, "ratings": { "title": "Only these star ratings", "type": "array", "description": "For example, 1 and 2 to collect only complaints. Leave empty for all ratings.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ] } }, "postedWithinDays": { "title": "Only reviews from the last N days", "minimum": 1, "type": "integer", "description": "Stop when reviews get older than this. Leave empty for no limit." }, "keywords": { "title": "Only reviews containing keywords", "type": "array", "description": "Keep reviews whose title or text contains any of these words (case-insensitive), e.g. crash, refund, subscription.", "items": { "type": "string" } }, "includeAppDetails": { "title": "Include app details and review summary", "type": "boolean", "description": "Adds one row per app and country with title, developer, overall rating, ratings count, installs, price, version, the rating distribution of the scraped reviews, and the top keywords in negative (1-2 star) and positive (4-5 star) reviews.", "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 } } } } } } } } } }