{ "openapi": "3.0.1", "info": { "title": "Google Play Store Reviews Scraper API: Android Ratings", "description": "Scrape Google Play reviews for any app and language, from app links or package names: rating, text, author, date, app version, helpful votes, developer reply. Full history, filters by rating, date and keyword.", "version": "0.1", "x-build-id": "QYQkaCQYPlryXnxzR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/quarra~google-play-store-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-quarra-google-play-store-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/quarra~google-play-store-reviews-scraper/runs": { "post": { "operationId": "runs-sync-quarra-google-play-store-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/quarra~google-play-store-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-quarra-google-play-store-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": "App links or package names", "type": "array", "description": "One per line: Google Play links (play.google.com/store/apps/details?id=com.whatsapp) or package names.", "items": { "type": "string", "maxLength": 2000 } }, "languages": { "title": "Languages", "type": "array", "description": "Review languages, one per line (en, fr, de, zh-TW…). Each app is read in each language; a regional variant (en-GB, pt-BR…) gives the same reviews as its language and is read once. Empty: the language of the link, otherwise en.", "items": { "type": "string", "maxLength": 12 } }, "countries": { "title": "Country", "type": "array", "description": "Google Play country, two letters (us, fr, in…). Google Play shows the same reviews in every country, so one is enough: only the first is used. It only changes the order of 'Most relevant' and the app rating. Empty: the country of the link, otherwise us.", "items": { "type": "string", "maxLength": 2 } }, "maxReviewsPerApp": { "title": "Max reviews per app and language", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop an app after this many reviews (per language).", "default": 100 }, "maxItems": { "title": "Max reviews in total", "minimum": 1, "maximum": 100000000, "type": "integer", "description": "Stop the run after this many reviews, all apps together.", "default": 1000 }, "sort": { "title": "Sort", "enum": [ "newest", "relevant", "rating" ], "type": "string", "description": "Order of the reviews. 'Newest first' is the one that lets 'Since' stop early.", "default": "newest" }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at least this many stars (1 to 5). Empty keeps all. Reviews that do not match are not charged." }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at most this many stars (1 to 5). Set both to 1 for one-star reviews only." }, "since": { "title": "Since", "type": "string", "description": "Only reviews from this date on: 2026-01-31, or a duration such as '30 days', '3 months'. Empty keeps all. With a date filter, the rare reviews that have no date are left out (not charged)." }, "until": { "title": "Until", "type": "string", "description": "Only reviews up to this date (included). Empty keeps all." }, "keywords": { "title": "Review contains", "maxItems": 50, "type": "array", "description": "Keep only reviews whose title or text contains one of these words (not case-sensitive). One per line, 50 at most.", "items": { "type": "string", "maxLength": 200 } }, "proxyConfiguration": { "title": "Connection", "type": "object", "description": "Connection. Keep the default (automatic). Costs are included in the price.", "default": { "useApifyProxy": true } }, "deliveryConnector": { "title": "Send results to your app (MCP connector: Notion, Slack…)", "type": "string", "description": "Pick one of your Apify MCP connectors: at the end of each run, a summary of the results (count, the first 25 with their links, a link to the full dataset) is posted there. With a schedule and 'Only new', you get each day's new results where your team works. Nothing is sent when a run finds nothing. Notion connects in one click; Slack and Google need your own OAuth app in Apify, or use the webhook field below." }, "deliveryTarget": { "title": "Where in the app (channel, page or sheet ID)", "type": "string", "description": "Slack channel ID (C0123…), Notion page ID, Google Sheet ID… Leave empty if the app needs no target (a new Notion page is then created at the top of your workspace)." }, "deliveryWebhookUrl": { "title": "Or a webhook URL (Slack, Discord, Make, Zapier, n8n)", "type": "string", "description": "No connector needed. A Slack Incoming Webhook (hooks.slack.com/…) gets a message, a Discord channel webhook gets a message, any other URL receives the summary as JSON (title, text, count, datasetUrl, items)." }, "deliveryTool": { "title": "Connector tool (advanced)", "type": "string", "description": "Name of the connector's tool to call. Leave empty: the best tool that posts a message, creates a page or appends rows is picked, and the run log lists every tool the connector offers." }, "deliveryArguments": { "title": "Connector tool arguments (advanced)", "type": "object", "description": "Extra arguments for the tool, merged last, for example {\"channel\": \"#reddit-leads\"} or {\"parent\": {\"database_id\": \"…\"}}." } } }, "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 } } } } } } } } } }