{ "openapi": "3.0.1", "info": { "title": "Google Play Scraper - App Reviews, Ratings, Installs, Details", "description": "Scrape public Google Play apps without login: reviews (newest, by stars, any language or country) and app details (rating, installs, price, developer). Paste app IDs or search.", "version": "0.1", "x-build-id": "a2g8i03xU35Nhx0Ml" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapefy~google-play-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapefy-google-play-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/scrapefy~google-play-scraper/runs": { "post": { "operationId": "runs-sync-scrapefy-google-play-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/scrapefy~google-play-scraper/run-sync": { "post": { "operationId": "run-sync-scrapefy-google-play-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 IDs or Google Play URLs", "type": "array", "description": "Package names such as com.spotify.music, or full Google Play links such as https://play.google.com/store/apps/details?id=com.whatsapp. One result set is returned per app.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries (find apps)", "type": "array", "description": "Optional words to search in the Google Play app search, for example 'photo editor'. The top matching apps (up to 'Max apps per search') are then scraped like the apps above.", "items": { "type": "string" } }, "mode": { "title": "What to scrape", "enum": [ "reviews", "appDetails", "both" ], "type": "string", "description": "Reviews returns user reviews, App details returns one row per app with rating, histogram, installs, price and developer, and both returns the two together. Each review and each app row is a separately priced event.", "default": "both" }, "maxReviews": { "title": "Max reviews per app", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of reviews returned for each app (about 100 per request). Keeps the cost of a run predictable because you are charged per review returned.", "default": 100 }, "sort": { "title": "Review sort order", "enum": [ "newest", "mostRelevant", "rating" ], "type": "string", "description": "Newest first is best for monitoring new feedback. Most relevant is the order shown first on the Google Play page. Rating sorts by star rating.", "default": "newest" }, "starFilter": { "title": "Only reviews with this star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Enter 1 to 5 to return only reviews with exactly that many stars, for example 1 to collect complaints. Leave empty for all ratings." }, "language": { "title": "Language", "type": "string", "description": "Google Play interface language code that selects the language of the store texts and the reviews shown, for example en, de, fr, es, pt, ja. Default is en.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter Google Play store country code, for example US, GB, DE, FR, BR, IN. It changes price, availability and the reviews shown. Default is US.", "default": "US" }, "maxAppsPerSearch": { "title": "Max apps per search", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many of the top search results to scrape for each search query (the Google Play results page lists up to about 20).", "default": 10 }, "useProxy": { "title": "Use Apify proxy", "type": "boolean", "description": "Route requests through the Apify datacenter proxy. Not needed normally; turn it on only if Google Play starts answering with 403 or 429 from your region.", "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 }, "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 } } } } } } } } } }