{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews Scraper + Insights", "description": "Scrape App Store and Google Play reviews in one run: any app, many countries, date and star filters. Every app also gets an insights summary with rating distribution and top complaint and praise phrases.", "version": "0.1", "x-build-id": "uBCYk9vr1CLgeWnNT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zahidthani~app-store-google-play-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zahidthani-app-store-google-play-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/zahidthani~app-store-google-play-reviews/runs": { "post": { "operationId": "runs-sync-zahidthani-app-store-google-play-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/zahidthani~app-store-google-play-reviews/run-sync": { "post": { "operationId": "run-sync-zahidthani-app-store-google-play-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", "properties": { "apps": { "title": "Apps", "type": "array", "description": "One per line: an App Store URL or numeric ID, a Google Play URL or package name (com.example.app), or just the app name (looked up in both stores).", "default": [ "Duolingo" ], "items": { "type": "string" } }, "stores": { "title": "Stores", "type": "array", "description": "Which stores to collect reviews from. Pick both to compare iPhone and Android users in one dataset.", "items": { "type": "string", "enum": [ "apple", "google" ], "enumTitles": [ "Apple App Store", "Google Play" ] }, "default": [ "apple", "google" ] }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes (us, gb, de, in...). Each country is fetched separately; the App Store shows different reviews per country.", "default": [ "us" ], "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app, store and country", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Apple's public feed returns at most 500 most-recent reviews per country. Google Play has no fixed limit.", "default": 200 }, "sort": { "title": "Sort", "enum": [ "newest", "helpful" ], "type": "string", "description": "Collect the newest reviews first, or the most helpful / relevant ones.", "default": "newest" }, "reviewsSince": { "title": "Only reviews since (optional)", "type": "string", "description": "Skip reviews older than this. A date (YYYY-MM-DD) or a relative period like '7 days', '2 weeks' or '1 month'. Relative periods are perfect for scheduled weekly monitoring." }, "minRating": { "title": "Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only keep reviews with at least this many stars (1-5).", "default": 1 }, "maxRating": { "title": "Maximum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only keep reviews with at most this many stars (1-5). Set to 2 to collect complaints only.", "default": 5 }, "includeAppSummary": { "title": "Add app summary & insights", "type": "boolean", "description": "One extra item per app: store rating, rating distribution of the fetched reviews, top complaint and praise phrases, developer reply rate.", "default": true }, "language": { "title": "Google Play language", "type": "string", "description": "Language code for Google Play reviews, e.g. en, es, de, fr.", "default": "en" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Off by default: the App Store and Google Play answer direct requests and are about 15x faster that way. Turn on Apify Proxy only for very large jobs if you see 'kept failing' errors.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }