{ "openapi": "3.0.1", "info": { "title": "App Reviews Scraper: Google Play & App Store", "description": "Scrape Google Play reviews and App Store reviews in one run: many apps, many countries. Rating, text, date, app version, helpful votes, developer replies and app details (rating, installs, price, genre). $0.15 per 1,000 reviews.", "version": "1.0", "x-build-id": "vQ8nuw15UgCa4P8x1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/umararshad2~app-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-umararshad2-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/umararshad2~app-reviews-scraper/runs": { "post": { "operationId": "runs-sync-umararshad2-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/umararshad2~app-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-umararshad2-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 or IDs, both stores)", "type": "array", "description": "Mix Google Play and App Store apps freely; the store is detected automatically. Google Play: package name (com.spotify.music) or play.google.com URL. App Store: apps.apple.com URL, numeric ID (324684580) or ios:bundle.id (ios:com.spotify.client).", "default": [ "com.spotify.music", "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580" ], "items": { "type": "string" } }, "searchTerms": { "title": "App names to search (App Store)", "type": "array", "description": "Optional. App names such as \"duolingo\"; the top App Store match in each country is used (official iTunes Search API). Google Play search pages are disallowed by Google's robots.txt, so for Google Play please give the package name or URL.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "2-letter country codes (us, gb, de, in, br, jp...). Each app is scraped in every country; reviews differ by country. Max 50.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Language code for Google Play reviews and app texts (en, de, fr, es, pt-BR, ja...). App Store reviews always come in the language people wrote them in that country.", "default": "en" }, "sort": { "title": "Sort reviews by", "enum": [ "newest", "mostRelevant", "lowestRating", "highestRating" ], "type": "string", "description": "Newest first, most relevant/helpful first, or by star rating. App Store: applied by Apple's feed (true newest or most helpful). Google Play: applied to the ~20 \"most relevant\" reviews the public app page shows, so \"Newest\" on Play is not the latest reviews (see README limits).", "default": "newest" }, "maxReviewsPerApp": { "title": "Max reviews per app and country", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop after this many reviews for each app in each country. Store limits: App Store about 500 per country, Google Play about 20 per country (see README).", "default": 10 }, "reviewsSince": { "title": "Only reviews since", "type": "string", "description": "Optional date cutoff: 2026-10-01, or relative like \"30 days\", \"2 weeks\", \"6 months\". Works best for the App Store. On Google Play it filters the ~20 \"most relevant\" reviews, so a short cutoff (e.g. 7 days) often returns few or no Play reviews." }, "ratings": { "title": "Star ratings to keep", "type": "array", "description": "Optional. Keep only these star ratings, e.g. 1 and 2 for complaints. Empty = all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "includeAppDetails": { "title": "Include app details", "type": "boolean", "description": "Add one app-details row per app and country: title, developer, rating, ratings count, rating histogram (Play), installs (Play), price, genre, last updated, version.", "default": true }, "proxyConfiguration": { "title": "Proxy (fallback only)", "type": "object", "description": "Requests go direct first. The proxy is used only if a store blocks direct requests. Datacenter proxy is enough.", "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 } } } } } } } } } }