{ "openapi": "3.0.1", "info": { "title": "Google Play Review Scraper [FAST] | Multi-App Ratings & Replies", "description": "Scrape Google Play reviews from up to 100 apps in one run. Get ratings, review text, helpful votes, and developer replies. Filter by stars, language, country, or date. Pay only for reviews delivered at $0.0001 per review ($0.10 per 1,000). Zero delivered reviews means zero review charges.", "version": "0.0", "x-build-id": "hoHsxYU8RO3TjTS31" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apizy~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apizy-google-play-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/apizy~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-apizy-google-play-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/apizy~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-apizy-google-play-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": { "app": { "title": "Single app — URL or package ID", "type": "string", "description": "Enter one Google Play URL or package ID, for example com.whatsapp. For multiple apps, clear this field and use Multiple apps instead." }, "apps": { "title": "Multiple apps — URLs or package IDs", "minItems": 1, "maxItems": 100, "type": "array", "description": "Optional. Enter one Google Play URL or package ID per line, up to 100 apps. Clear Single app before using this list.", "items": { "type": "string" } }, "maxReviews": { "title": "Maximum reviews per app", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum reviews to save for each app, after any filters. For example, 3 apps × 100 means up to 300 review rows in total. Google Play may return fewer reviews.", "default": 100 }, "country": { "title": "Store country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter Google Play store country code: us = United States, gb = United Kingdom, au = Australia, sg = Singapore. Default: us.", "default": "us" }, "language": { "title": "Review language", "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z]{2})?$", "type": "string", "description": "Google Play review language code: en = English, es = Spanish, de = German, fr = French, pt-BR = Brazilian Portuguese. Selects the review source language; the Actor does not translate reviews. Default: en.", "default": "en" }, "sortBy": { "title": "Sort reviews", "enum": [ "newest", "rating", "helpful" ], "type": "string", "description": "Choose Newest first, Highest rating first, or Google’s Most helpful order. Keep Newest first when using Reviews since date.", "default": "newest" }, "starRating": { "title": "Only reviews with this star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Enter a whole number from 1 to 5: 1 = one-star reviews, 5 = five-star reviews. Leave empty to include all star ratings." }, "sinceDate": { "title": "Reviews since date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional. Pick an inclusive start date (UTC), or enter YYYY-MM-DD. Requires Newest first. Older reviews are neither saved nor charged as review results." } } }, "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 } } } } } } } } } }