{ "openapi": "3.0.1", "info": { "title": "App Reviews API: Google Play Reviews + App Store Reviews", "description": "App reviews API and app review scraper for Google Play and the App Store: package names, App Store IDs or URLs and iOS bundle IDs in one list, one table of reviews out (rating, text, date, app version, developer reply). Filter by rating, country, date; only-new mode. $0.09/1k reviews. Unofficial.", "version": "0.1", "x-build-id": "qYpMxu5h4cM3RxcLa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hiver~app-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hiver-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/hiver~app-reviews-scraper/runs": { "post": { "operationId": "runs-sync-hiver-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/hiver~app-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-hiver-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 URLs, Google Play package IDs, numeric App Store IDs or iOS bundle IDs (com.spotify.client), one per line. Unprefixed dotted IDs try Google Play first, then the App Store if not found. Force a store with ios: / appstore: or android: / play: (case-insensitive). App Store URLs with /gb/ use that country for that app.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter store countries, for example `us`, `gb`, `de`. Each store lists reviews per country, so every app is fetched once per country listed.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Two-letter interface language, for example `en`, `de`, `fr`. It sets the language of the store page and labels; reviews come back in the language their authors wrote them in.", "default": "en" }, "sort": { "title": "Sort", "enum": [ "newest", "mostHelpful" ], "type": "string", "description": "Newest first (default), or the store's own 'most helpful' order. 'Only new' mode always uses newest.", "default": "newest" }, "maxReviewsPerApp": { "title": "Max reviews per app and country", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Reviews that match your filters, 1 to 5000.", "default": 100 }, "sinceDate": { "title": "Only reviews since (optional)", "type": "string", "description": "Date as `YYYY-MM-DD`. Older reviews are skipped." }, "ratings": { "title": "Only these star ratings (optional)", "type": "array", "description": "For example `1` and `2` for complaints. Leave empty for all ratings.", "items": { "type": "string" } }, "onlyNew": { "title": "Only new since last run", "type": "boolean", "description": "Return only reviews not returned by an earlier run with the same Monitor ID. The first run returns the latest reviews and sets the baseline. Schedule the Actor (hourly, daily) and send the dataset to Slack, email or a webhook.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Names the saved state for 'only new'. Use a different ID for each watchlist.", "default": "default" }, "dottedIdStore": { "title": "Store for dotted IDs", "enum": [ "auto", "app_store", "google_play" ], "type": "string", "description": "For unprefixed dotted IDs: auto tries Google Play first, then Apple if missing; app_store treats them as iOS bundle IDs; google_play uses only Play. Explicit prefixes and store URLs override this setting.", "default": "auto" } } }, "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 } } } } } } } } } }