{
"openapi": "3.0.1",
"info": {
"title": "Google Play Reviews Scraper – Apps, Search & Top Charts",
"description": "Google Play reviews scraper: extract Google Play Store app reviews, app details, keyword search results, developer apps and top charts (free, paid, grossing) for any country and language. Fast HTTP-only, no browser, pay only per result.",
"version": "1.0",
"x-build-id": "3fZZlBKtEY9r1ksWr"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/openharvest~google-play-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-openharvest-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/openharvest~google-play-scraper/runs": {
"post": {
"operationId": "runs-sync-openharvest-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/openharvest~google-play-scraper/run-sync": {
"post": {
"operationId": "run-sync-openharvest-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",
"required": [
"mode"
],
"properties": {
"mode": {
"title": "What to scrape",
"enum": [
"appDetails",
"reviews",
"search",
"developer",
"topCharts"
],
"type": "string",
"description": "App details – full details for app IDs/URLs (optionally with reviews).
Reviews – user reviews for app IDs/URLs.
Search – apps matching keywords.
Developer – all apps of a developer.
Top charts – top free / paid / grossing apps in a category.",
"default": "appDetails"
},
"appIds": {
"title": "App IDs or Google Play URLs",
"type": "array",
"description": "Used by App details and Reviews modes. Enter package names (e.g. com.spotify.music) or full URLs like https://play.google.com/store/apps/details?id=com.spotify.music.",
"default": [
"com.spotify.music"
],
"items": {
"type": "string"
}
},
"includeReviews": {
"title": "Also scrape reviews (App details mode)",
"type": "boolean",
"description": "In App details mode, also scrape up to Max reviews per app reviews for every app.",
"default": false
},
"searchTerms": {
"title": "Search keywords",
"type": "array",
"description": "Used by Search mode. One keyword per line, e.g. vpn, photo editor. Google Play returns up to ~30–50 apps per keyword, so add more specific keywords to get more apps.",
"items": {
"type": "string"
}
},
"searchPrice": {
"title": "Search price filter",
"enum": [
"all",
"free",
"paid"
],
"type": "string",
"description": "Used by Search mode. Restrict results to free or paid apps.",
"default": "all"
},
"developerIds": {
"title": "Developers",
"type": "array",
"description": "Used by Developer mode. Developer name exactly as shown on Google Play (e.g. Spotify AB), numeric developer ID (e.g. 5700313618786177705) or developer page URL.",
"items": {
"type": "string"
}
},
"collection": {
"title": "Top chart",
"enum": [
"TOP_FREE",
"TOP_PAID",
"TOP_GROSSING"
],
"type": "string",
"description": "Used by Top charts mode.",
"default": "TOP_FREE"
},
"category": {
"title": "Category",
"enum": [
"APPLICATION",
"GAME",
"FAMILY",
"ANDROID_WEAR",
"ART_AND_DESIGN",
"AUTO_AND_VEHICLES",
"BEAUTY",
"BOOKS_AND_REFERENCE",
"BUSINESS",
"COMICS",
"COMMUNICATION",
"DATING",
"EDUCATION",
"ENTERTAINMENT",
"EVENTS",
"FINANCE",
"FOOD_AND_DRINK",
"HEALTH_AND_FITNESS",
"HOUSE_AND_HOME",
"LIBRARIES_AND_DEMO",
"LIFESTYLE",
"MAPS_AND_NAVIGATION",
"MEDICAL",
"MUSIC_AND_AUDIO",
"NEWS_AND_MAGAZINES",
"PARENTING",
"PERSONALIZATION",
"PHOTOGRAPHY",
"PRODUCTIVITY",
"SHOPPING",
"SOCIAL",
"SPORTS",
"TOOLS",
"TRAVEL_AND_LOCAL",
"VIDEO_PLAYERS",
"WATCH_FACE",
"WEATHER",
"GAME_ACTION",
"GAME_ADVENTURE",
"GAME_ARCADE",
"GAME_BOARD",
"GAME_CARD",
"GAME_CASINO",
"GAME_CASUAL",
"GAME_EDUCATIONAL",
"GAME_MUSIC",
"GAME_PUZZLE",
"GAME_RACING",
"GAME_ROLE_PLAYING",
"GAME_SIMULATION",
"GAME_SPORTS",
"GAME_STRATEGY",
"GAME_TRIVIA",
"GAME_WORD"
],
"type": "string",
"description": "Used by Top charts mode. APPLICATION = all apps, GAME = all games.",
"default": "APPLICATION"
},
"maxItems": {
"title": "Max apps per keyword / developer / chart",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Maximum number of app results per search keyword, per developer, or for the top chart (Google Play top charts contain up to 200 apps).",
"default": 50
},
"maxReviews": {
"title": "Max reviews per app",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "Maximum number of reviews per app (Reviews mode, or App details mode with reviews enabled). Popular apps have tens of thousands of reviews available.",
"default": 100
},
"fullDetails": {
"title": "Fetch full app details for list results",
"type": "boolean",
"description": "For Search, Developer and Top charts: open every app's detail page to get the full data set (description, installs, ratings count, histogram, release/update dates, version, developer contacts...). Slower, same price per app.",
"default": false
},
"reviewsSort": {
"title": "Reviews sort order",
"enum": [
"newest",
"relevance",
"rating"
],
"type": "string",
"description": "Order in which reviews are scraped.",
"default": "newest"
},
"reviewsRating": {
"title": "Only reviews with rating",
"enum": [
"all",
"1",
"2",
"3",
"4",
"5"
],
"type": "string",
"description": "Only scrape reviews with this star rating.",
"default": "all"
},
"country": {
"title": "Country (gl)",
"type": "string",
"description": "Two-letter ISO country code of the Play Store to scrape, e.g. us, gb, de, tr, in. Affects prices, availability, charts and reviews.",
"default": "us"
},
"language": {
"title": "Language (hl)",
"type": "string",
"description": "Language code for texts and reviews, e.g. en, de, tr, pt-BR.",
"default": "en"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional. Google Play usually works without a proxy. Enable Apify Proxy if you scrape at very high volume or see blocking.",
"default": {
"useApifyProxy": 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
}
}
}
}
}
}
}
}
}
}