# Google Play Scraper - Rankings, Reviews & App Details (`haketa/google-play-scraper`) Actor Google Play scraper & API: export top-chart rankings by category & country, app reviews & ratings, full app details and ASO keyword search. Android app market intelligence, review analysis and competitor tracking — fast, no login. Pairs with an Apple App Store scraper. - **URL**: https://apify.com/haketa/google-play-scraper.md - **Developed by:** [Haketa](https://apify.com/haketa) (community) - **Categories:** SEO tools, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.18 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Google Play Scraper 📱 — Rankings, Reviews & App Details Scrape **Google Play Store** data as clean, structured JSON — **top-chart rankings by category & country, full app reviews (uncapped & paginated), complete app details, and keyword search.** One actor, four jobs. Fast and reliable: API-first, no headless browser, with proxy rotation and **fully-paginated reviews with no artificial cap** (the thing most Play scrapers get wrong). > 💡 **The differentiator:** most Google Play actors only do app details + a handful of reviews. This one owns **top-chart rankings** (a Sensor-Tower-style market-intelligence feed: any category × any country × Top Free / Paid / Grossing) **and** delivers reviews at scale. --- ### 📋 Table of contents - [What does it do?](#what-does-it-do) - [Use cases](#use-cases) - [How to use it](#how-to-use-it-step-by-step) - [Input parameters](#input-parameters) - [Input examples](#input-examples) - [Output — data fields](#output--data-fields) - [Sample output records](#sample-output-records) - [Categories & countries](#categories--countries) - [Tips & best practices](#tips--best-practices) - [Frequently asked questions](#frequently-asked-questions) - [Changelog](#changelog) --- ### What does it do? Pick a **mode** and get clean data: - 🏆 **Rankings** — the Top Free / Top Paid / Top Grossing charts for any category and country (up to ~660 apps per chart, with rank position). - 💬 **Reviews** — every public review for an app, fully paginated (sort by newest / rating / helpfulness), with rating, text, date, thumbs-up, developer reply and app version. - 📋 **App details** — complete app info: rating, ratings & reviews count, **ratings histogram**, installs, price, IAP, developer, category, content rating, version, screenshots and more. - 🔎 **Search** — apps for a keyword (great for ASO / keyword-rank tracking). Export to **JSON, CSV, Excel, XML or HTML**, or pull from the **Apify API**. Everything is localized by **country (`gl`)** and **language (`hl`)**. --- ### Use cases **📈 ASO & app market intelligence** - Track **top-chart rankings daily** by category and country (a low-cost Sensor Tower / data.ai alternative). - Monitor where apps rank for keywords; benchmark competitors. **💬 Review analysis & product teams** - Pull all reviews for your app (and competitors') for sentiment, bugs and feature requests. - Track rating trends and developer responses. **🏢 Competitive & investment research** - See who's climbing the charts in any market. - Compare installs, ratings and monetization across apps. **🤖 Data & AI teams** - Build app datasets, review-sentiment models and ranking dashboards. --- ### How to use it (step by step) No coding required. 1. Click **Try for free / Start**. 2. Choose a **mode**: - **Rankings** → pick a **chart** (Top Free/Paid/Grossing), **category** and **country**. - **Reviews / App details** → add **App IDs** (e.g. `com.whatsapp`) or Play URLs. - **Search** → add **search terms**. 3. Set **country** and **language**, and **Max items**. 4. Click **Save & Start**, then export the results. --- ### Input parameters | Field | Type | Description | |------|------|-------------| | `mode` | string | `rankings`, `reviews`, `appDetails`, or `search`. | | `collection` | string | Rankings chart: `TOP_FREE`, `TOP_PAID`, `GROSSING`. | | `category` | string | Rankings category, e.g. `APPLICATION`, `GAME`, `SOCIAL`, `FINANCE`, `GAME_ACTION`. | | `appIds` | array | App package names or URLs (reviews & appDetails modes). | | `searchTerms` | array | Keywords (search mode). | | `maxReviewsPerApp` | integer | Reviews per app, fully paginated. Default `200`. | | `reviewsSort` | string | `NEWEST`, `RATING`, or `HELPFULNESS`. | | `country` | string | Country code (`gl`), e.g. `us`, `gb`, `de`, `tr`. | | `language` | string | Language code (`hl`), e.g. `en`, `de`, `tr`. | | `fullDetail` | boolean | Fetch full app details for each ranked/found app. | | `maxItems` | integer | Max records. `0` = no limit. Default `1000`. | | `proxyConfiguration` | object | Proxy settings. Default: Apify Proxy on. | | `maxConcurrency` | integer | Parallel apps processed. Default `4`. | --- ### Input examples **1) Top free apps in the US** ```json { "mode": "rankings", "collection": "TOP_FREE", "category": "APPLICATION", "country": "us", "maxItems": 200 } ```` **2) Top grossing games in Germany** ```json { "mode": "rankings", "collection": "GROSSING", "category": "GAME", "country": "de" } ``` **3) All reviews for an app (newest first)** ```json { "mode": "reviews", "appIds": ["com.whatsapp", "com.spotify.music"], "maxReviewsPerApp": 1000, "reviewsSort": "NEWEST", "country": "us" } ``` **4) App details** ```json { "mode": "appDetails", "appIds": ["com.instagram.android"] } ``` **5) Keyword search (ASO)** ```json { "mode": "search", "searchTerms": ["photo editor", "budget tracker"], "country": "us" } ``` *** ### Output — data fields **Ranked app** (`recordType: "rankedApp"`): `rank`, `collection`, `rankCategory`, `country`, plus all app fields below. **App** (`recordType: "app"` / ranked / search): `appId`, `title`, `url`, `summary`, `developer`, `developerId`, `developerEmail`, `developerWebsite`, `score`, `scoreText`, `ratings`, `reviews`, `histogram`, `installs`, `minInstalls`, `maxInstalls`, `price`, `free`, `currency`, `priceText`, `offersIAP`, `IAPRange`, `adSupported`, `genre`, `genreId`, `categories`, `contentRating`, `androidVersion`, `version`, `updated`, `recentChanges`, `icon`, `headerImage`, `screenshots`, `video`, `privacyPolicy`, `editorsChoice`. **Review** (`recordType: "review"`): `appId`, `reviewId`, `userName`, `userImage`, `score`, `title`, `text`, `date`, `thumbsUp`, `version`, `replyText`, `replyDate`, `criterias` (per-feature ratings), `url`. *** ### Sample output records **Ranked app:** ```json { "recordType": "rankedApp", "rank": 1, "collection": "TOP_FREE", "rankCategory": "APPLICATION", "country": "us", "appId": "com.whatsapp", "title": "WhatsApp Messenger", "developer": "WhatsApp LLC", "score": 4.2, "ratings": 184000000, "installs": "5,000,000,000+", "free": true, "url": "https://play.google.com/store/apps/details?id=com.whatsapp" } ``` **Review:** ```json { "recordType": "review", "appId": "com.whatsapp", "reviewId": "gp:AOq...", "userName": "Jane D.", "score": 5, "text": "Works great, love the new updates!", "date": "2026-06-01T10:22:00.000Z", "thumbsUp": 14, "version": "2.26.5", "replyText": null } ``` *** ### Categories & countries - **Charts:** `TOP_FREE`, `TOP_PAID`, `GROSSING`. - **Categories:** `APPLICATION` (all apps), `GAME` (all games), and specific ones such as `SOCIAL`, `COMMUNICATION`, `FINANCE`, `PRODUCTIVITY`, `PHOTOGRAPHY`, `SHOPPING`, `HEALTH_AND_FITNESS`, `TOOLS`, `ENTERTAINMENT`, `MUSIC_AND_AUDIO`, plus game subcategories like `GAME_ACTION`, `GAME_PUZZLE`, `GAME_STRATEGY`. - **Countries / languages:** any market via `country` (gl) + `language` (hl). Iterate countries to build a global ranking picture. *** ### Tips & best practices - 🏆 **Rankings are recurring** — schedule a daily run per category/country to track movement over time. - 🌍 **Iterate countries** to compare charts across markets. - 💬 **Set `maxReviewsPerApp` high** for full review history (Google serves up to ~4,500 per app); reviews are fully paginated. - ⚡ **Keep concurrency moderate** and proxy on for large review jobs to avoid rate-limiting. - 💾 **Use the Apify API / integrations** to push results into Google Sheets, a database, or a webhook. *** ### Frequently asked questions **Can I get the top-chart rankings for a specific category and country?** Yes — that's the rankings mode: pick chart + category + country. **Is there a review limit?** Reviews are fully paginated up to Google's per-app ceiling (~4,500). Set `maxReviewsPerApp` to control how many. **Are prices and rankings localized?** Yes — everything respects `country` (gl) and `language` (hl). **Can I scrape app details and the ratings histogram?** Yes — appDetails mode returns full info including the 1–5 star histogram. **What export formats are supported?** JSON, CSV, Excel, XML, HTML table, RSS — plus the Apify API and integrations. *** ### Changelog **0.1.0** - Initial release: rankings (Top Free/Paid/Grossing by category & country), uncapped paginated reviews, full app details, and keyword search. - Localized by country & language; proxy rotation; one mode-switched actor. # Actor input Schema ## `mode` (type: `string`): rankings = top-chart apps by category & country; reviews = app reviews; appDetails = full app info; search = apps for a keyword. ## `collection` (type: `string`): Which top chart to scrape. ## `category` (type: `string`): Category for the ranking chart. Use APPLICATION for all apps or GAME for all games; or a specific one (e.g. SOCIAL, FINANCE, GAME\_ACTION). ## `appIds` (type: `array`): App package names (e.g. com.whatsapp) or full Play Store URLs. ## `searchTerms` (type: `array`): Keywords to search for apps. ## `maxReviewsPerApp` (type: `integer`): Reviews to pull per app (fully paginated, no artificial cap). Google serves up to ~4500 per app. ## `reviewsSort` (type: `string`): Order of reviews. ## `country` (type: `string`): Two-letter country code, e.g. us, gb, de, tr, in. Rankings, prices and reviews are localized per country. ## `language` (type: `string`): Two-letter language code, e.g. en, de, tr. ## `fullDetail` (type: `boolean`): Fetch complete app details for each ranked / found app — adds installs, ratings count, reviews count, histogram, version, etc. ON by default (a rank list without install/rating counts is far less useful). Turn OFF for a faster, lighter rank-only list (title, developer, score, price). ## `maxItems` (type: `integer`): Maximum number of records (apps or reviews). Use 0 for no limit. ## `proxyConfiguration` (type: `object`): Default Apify Proxy is fine. For very large review pulls, RESIDENTIAL reduces rate-limiting. ## `maxConcurrency` (type: `integer`): Maximum parallel apps processed. ## Actor input object example ```json { "mode": "rankings", "collection": "TOP_FREE", "category": "APPLICATION", "appIds": [ "com.whatsapp" ], "maxReviewsPerApp": 200, "reviewsSort": "NEWEST", "country": "us", "language": "en", "fullDetail": true, "maxItems": 1000, "proxyConfiguration": { "useApifyProxy": true }, "maxConcurrency": 4 } ``` # Actor output Schema ## `results` (type: `string`): All records collected during the run. ## `runUrl` (type: `string`): Open this run in the Apify Console. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "appIds": [ "com.whatsapp" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("haketa/google-play-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "appIds": ["com.whatsapp"], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("haketa/google-play-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "appIds": [ "com.whatsapp" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call haketa/google-play-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=haketa/google-play-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Play Scraper - Rankings, Reviews & App Details", "description": "Google Play scraper & API: export top-chart rankings by category & country, app reviews & ratings, full app details and ASO keyword search. Android app market intelligence, review analysis and competitor tracking — fast, no login. Pairs with an Apple App Store scraper.", "version": "0.1", "x-build-id": "7S5Cg0ZptCaMGXpeB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/haketa~google-play-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-haketa-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/haketa~google-play-scraper/runs": { "post": { "operationId": "runs-sync-haketa-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/haketa~google-play-scraper/run-sync": { "post": { "operationId": "run-sync-haketa-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": { "mode": { "title": "What to scrape", "enum": [ "rankings", "reviews", "appDetails", "search" ], "type": "string", "description": "rankings = top-chart apps by category & country; reviews = app reviews; appDetails = full app info; search = apps for a keyword.", "default": "rankings" }, "collection": { "title": "Ranking chart (rankings mode)", "enum": [ "TOP_FREE", "TOP_PAID", "GROSSING" ], "type": "string", "description": "Which top chart to scrape.", "default": "TOP_FREE" }, "category": { "title": "Category (rankings mode)", "type": "string", "description": "Category for the ranking chart. Use APPLICATION for all apps or GAME for all games; or a specific one (e.g. SOCIAL, FINANCE, GAME_ACTION).", "default": "APPLICATION" }, "appIds": { "title": "App IDs / URLs (reviews & appDetails modes)", "type": "array", "description": "App package names (e.g. com.whatsapp) or full Play Store URLs.", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms (search mode)", "type": "array", "description": "Keywords to search for apps.", "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app (reviews mode)", "minimum": 1, "type": "integer", "description": "Reviews to pull per app (fully paginated, no artificial cap). Google serves up to ~4500 per app.", "default": 200 }, "reviewsSort": { "title": "Reviews sort (reviews mode)", "enum": [ "NEWEST", "RATING", "HELPFULNESS" ], "type": "string", "description": "Order of reviews.", "default": "NEWEST" }, "country": { "title": "Country (gl)", "type": "string", "description": "Two-letter country code, e.g. us, gb, de, tr, in. Rankings, prices and reviews are localized per country.", "default": "us" }, "language": { "title": "Language (hl)", "type": "string", "description": "Two-letter language code, e.g. en, de, tr.", "default": "en" }, "fullDetail": { "title": "Full app details (rankings & search)", "type": "boolean", "description": "Fetch complete app details for each ranked / found app — adds installs, ratings count, reviews count, histogram, version, etc. ON by default (a rank list without install/rating counts is far less useful). Turn OFF for a faster, lighter rank-only list (title, developer, score, price).", "default": true }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of records (apps or reviews). Use 0 for no limit.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Default Apify Proxy is fine. For very large review pulls, RESIDENTIAL reduces rate-limiting.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 15, "type": "integer", "description": "Maximum parallel apps processed.", "default": 4 } } }, "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 } } } } } } } } } } ```