{ "openapi": "3.0.1", "info": { "title": "Google Play Review Intelligence", "description": "Google Play reviews across many languages in one run, with rating by app version, release regression flags, per locale sentiment, complaint themes, developer reply rate and joined app metadata. Export normalized records, use the API, schedule monitoring, or connect integrations and agent workflows.", "version": "1.0", "x-build-id": "6jwvCRTYx7HjfxpQ4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/skootle~google-play-review-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-skootle-google-play-review-intelligence", "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/skootle~google-play-review-intelligence/runs": { "post": { "operationId": "runs-sync-skootle-google-play-review-intelligence", "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/skootle~google-play-review-intelligence/run-sync": { "post": { "operationId": "run-sync-skootle-google-play-review-intelligence", "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": [ "appIds" ], "properties": { "appIds": { "title": "Android app IDs or Play Store URLs", "minItems": 1, "maxItems": 10, "type": "array", "description": "One to ten Android package names such as com.spotify.music, or full Google Play app URLs. The package name is pulled out of a URL automatically.", "items": { "type": "string" } }, "languages": { "title": "Review languages", "minItems": 1, "maxItems": 12, "type": "array", "description": "Google Play returns a different set of public reviews for every language. Listing several languages here is what multiplies your coverage: five languages returned five times the unique reviews of one language in our verification runs. Duplicates are removed before you are billed.", "default": [ "en" ], "items": { "type": "string" } }, "countries": { "title": "Country storefronts", "minItems": 1, "maxItems": 10, "type": "array", "description": "Two-letter country codes. Countries are collected alongside languages and every review is labelled with the locale it came from. Country alone changes little on Google Play, language is the axis that matters.", "default": [ "us" ], "items": { "type": "string" } }, "sortBy": { "title": "Sort reviews by", "enum": [ "newest", "rating", "mostRelevant" ], "type": "string", "description": "Newest first is the right choice for release monitoring and regression detection.", "default": "newest" }, "maxReviewsPerLocale": { "title": "Max reviews per app per locale", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper bound per app and locale. Locales are languages multiplied by countries, capped at 40 pairs per run.", "default": 100 }, "minRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews at or above this rating. Leave empty for all ratings." }, "maxRating": { "title": "Maximum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews at or below this rating. Set to 2 to pull complaints only." }, "appVersions": { "title": "App versions filter", "maxItems": 20, "type": "array", "description": "Keep only reviews written against these exact app versions, for example 9.1.64.1676. Leave empty for all versions.", "default": [], "items": { "type": "string" } }, "includeAppDetails": { "title": "Join app metadata", "type": "boolean", "description": "Adds app title, developer, lifetime store rating, rating count, category and price to each app summary.", "default": true }, "expectedNoMatch": { "title": "This query is expected to return nothing", "type": "boolean", "description": "Leave off for normal runs. When off, a run that finds zero reviews fails and saves diagnostic evidence instead of quietly returning an empty dataset.", "default": 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 } } }, "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 } } } } } } } } } }