# Google Play Store Scraper: Apps, Charts & ASO (`robertosan16/google-play-scraper`) Actor Scrape Google Play Store app data: top free, paid and grossing charts for any country and category, keyword search rankings for ASO, developer catalogs, ratings, installs, prices, versions and contacts. No browser, no API key. - **URL**: https://apify.com/robertosan16/google-play-scraper.md - **Developed by:** [Robert Khairislamov](https://apify.com/robertosan16) (community) - **Categories:** Developer tools, SEO tools, E-commerce - **Features:** Limited permissions - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.05 / 1,000 app 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Google Play Scraper: Apps & Top Charts Scrape the Google Play Store: **top charts** (top free, top paid, top grossing) for any country and category, **keyword search rankings**, full **app details** and **developer catalogs**. Get ratings, rating histograms, installs, prices, in-app purchases, versions, update dates, developer contacts and descriptions in clean JSON, CSV or Excel. Fast and light: no browser, no login, no API key. ### What can this Google Play scraper do? - 🏆 **Top charts for any country**: top free, top paid and top grossing, for all apps, all games or any of 54 categories, up to 200 places each, with the rank of every app. - 🔎 **Keyword search rankings**: the apps Google Play shows for a keyword, in order, for ASO keyword tracking and competitor research. - 📱 **Full app details**: rating, ratings count, 1–5 star histogram, installs (with Google's install estimate), price and discounts, in-app purchase range, ads, content rating, version, minimum Android version, release and update dates, what's new, description, icon, screenshots and video. - 🏢 **Developer catalogs**: every app of a developer, by name, ID or link. - 🧭 **Similar apps**: the apps Google Play shows as similar to an app, up to about 50: a quick list of its competitors. - 📇 **Developer contacts for B2B research**: the support email, website and privacy policy each app publishes on Google Play, and for developer companies the legal name, postal address and phone of the trader details Google shows under "App support". - 🌍 **Many countries in one run**: prices, charts and rankings differ by country, so every source is scraped for each country you add, in 30+ languages. - ⚡ **Lists without details** when you need speed: thousands of chart positions in seconds. - 🤝 **Same output as our [App Store Scraper](https://apify.com/robertosan16/app-store-scraper)**: the same field names for title, developer, rating, price, version and dates, so Android and iOS apps fit into one table. ### What data does it extract? | Field | Example | |---|---| | `rank` / `source` | 1 / chart | | `title` / `appId` | Royal Match / com.dreamgames.royalmatch | | `developer` / `developerEmail` / `developerWebsite` | Dream Games, Ltd. / contact@dreamgames.com / https://dreamgames.com | | `developerLegalName` / `developerAddress` / `developerPhone` | Spotify AB / Regeringsgatan 19, 111 53 Stockholm, Sweden / +46 10 334 03 65 | | `score` / `ratingsCount` / `histogram` | 4.58 / 10,793,185 / `{ "1": 388654, …, "5": 8222659 }` | | `installs` / `minInstalls` / `maxInstalls` | 100,000,000+ / 100000000 / 370378754 | | `priceText` / `price` / `currency` | Free / 0 / GBP | | `inAppPurchaseRange` / `containsAds` | £0.79 - £99.99 / false | | `genre` / `categories` | Puzzle / Puzzle, Casual | | `version` / `updatedAt` / `releasedAt` | 38174 / 2026-08-28 / 2020-07-18 | | `summary` / `description` / `recentChanges` | texts from the app page | | `icon` / `screenshots` / `videoUrl` | image and video links | | `chart` / `chartCategory` / `searchTerm` / `country` | topgrossing / GAME_PUZZLE / – / GB | ### How to scrape Google Play 1. Choose what to scrape: **top charts** and categories, **search keywords**, **apps** (package names or links), **developers** and **similar apps** of an app (its competitors). You can combine them. 2. Add the **countries**, for example `US`, `GB`, `DE`, `JP`, and pick the language. 3. Keep **Load full app details** on for complete data, or turn it off for fast lists. 4. Click **Start** and download the results as JSON, CSV, Excel or HTML, or use them through the API. A step-by-step guide with Python examples, one app tracked across six keywords in three countries and who ranks above it: [How to Track Your App's Keyword Rankings on Google Play, in Any Country](https://medium.com/@robertkhairislamov/how-to-track-your-apps-keyword-rankings-on-google-play-in-any-country-b12ef638d821). #### Example input ```json { "charts": ["topgrossing"], "chartCategories": ["GAME_PUZZLE", "GAME_CASUAL"], "chartDepth": 100, "searchTerms": ["habit tracker", "budget planner"], "appIds": ["com.spotify.music"], "developers": ["Dream Games, Ltd."], "countries": ["US", "GB", "DE"], "language": "en" } ``` #### Example output ```json { "appId": "com.dreamgames.royalmatch", "url": "https://play.google.com/store/apps/details?id=com.dreamgames.royalmatch", "title": "Royal Match", "developer": "Dream Games, Ltd.", "developerId": "Dream Games, Ltd.", "developerUrl": "https://play.google.com/store/apps/developer?id=Dream+Games,+Ltd.", "developerEmail": "contact@dreamgames.com", "developerWebsite": "https://dreamgames.com", "privacyPolicyUrl": "https://dreamgames.com/en/privacy", "genre": "Puzzle", "genreId": "GAME_PUZZLE", "categories": [{ "id": "GAME_PUZZLE", "name": "Puzzle" }, { "id": "GAME_CASUAL", "name": "Casual" }], "score": 4.5771585, "ratingsCount": 10793185, "reviewsCount": 16973, "histogram": { "1": 388654, "2": 157665, "3": 511700, "4": 1512280, "5": 8222659 }, "installs": "100,000,000+", "minInstalls": 100000000, "maxInstalls": 370378754, "free": true, "price": 0, "originalPrice": null, "currency": "GBP", "priceText": "Free", "offersInAppPurchases": true, "inAppPurchaseRange": "£0.79 - £99.99 if billed through Play", "containsAds": false, "contentRating": "PEGI 3", "contentRatingDescription": null, "releasedAt": "2020-07-18", "releasedText": "Jul 18, 2020", "updatedAt": "2026-08-28T16:32:18.000Z", "version": "38174", "minAndroidVersion": "7.0", "summary": "Decorate King Robert's Castle by solving puzzles along the way!", "description": "Welcome to Royal Match, the king of puzzle games! Swipe colors, solve …", "descriptionHtml": "Welcome to Royal Match, the king of puzz…", "recentChanges": "Are you ready for a fun new update?…", "icon": "https://play-lh.googleusercontent.com/RBnqZ3q_jjOREX6v49DGe4…", "headerImage": "https://play-lh.googleusercontent.com/UmAgRAe2pCoKUPVRv7bTY8…", "screenshots": ["https://play-lh.googleusercontent.com/3DKrw93wnfUX3QR1diWf-R…"], "videoUrl": null, "playPass": false, "preregistration": false, "source": "chart", "rank": 1, "searchTerm": null, "chart": "topgrossing", "chartCategory": "GAME_PUZZLE", "developerQuery": null, "country": "GB", "language": "en", "scrapedAt": "2026-09-24T16:21:28.997Z" } ``` ### Use cases - **App Store Optimization (ASO)**: track where your app ranks for keywords and in category charts, in every country, every day. - **Market and competitor research**: see which apps lead a category, how they monetize, how often they update and how users rate them. - **Top chart monitoring**: record top free, paid and grossing charts over time to spot rising apps and trends. - **B2B lead generation**: build lists of app publishers in a category with their support email and website. - **Android and iOS side by side**: run this Actor and our [App Store Scraper](https://apify.com/robertosan16/app-store-scraper) with the same keywords and countries, and compare both stores in one table. - **Investors and analysts**: follow installs, ratings and chart positions of apps and publishers. - **Datasets and AI**: clean, structured app metadata and descriptions for classification, search and LLM pipelines. ### How much does it cost? You pay only for results: **$1.50 per 1,000 results**. That is the price on the Apify Free plan. Paid Apify plans pay less: $1.35 per 1,000 results on Starter, $1.20 on Scale and $1.05 on Business, which is the "from" price shown in Apify Store. There is no start fee. The Apify free plan covers about 3,300 results every month. ### Tips - **Keyword rank tracking with changes**: to follow your apps' positions for a list of keywords in both stores, with the change since the last run and search suggestions, use [ASO Keyword Rank Tracker](https://apify.com/robertosan16/aso-keyword-tracker). - **Contacts of app companies**: to reach the companies behind the apps, use [Google Play Developer Leads](https://apify.com/robertosan16/google-play-developer-leads): one record per company with business email, website, address and top app, for a keyword, category or competitor app. - **Daily rank tracking**: save your input as a task and add a schedule. Every run records the current rank of each app, so you can chart positions over time. - **Fast chart lists**: turn off **Load full app details** to get ranks, titles, developers, ratings, installs and prices of thousands of apps in seconds. - **Games charts**: pick "All games" or a game genre in **Chart categories**. - **Errors per source**: see the `SUMMARY` record in the run's key-value store. ### FAQ **Why not just ask an AI chatbot?** A chatbot with web search knows some popular apps and reads a few store pages, so it cannot give you a full top chart for a country or every app that ranks for a keyword, and the ratings and installs it repeats may be old. This Actor reads Google Play itself: whole charts, keyword rankings and developer catalogs, with ratings, installs, prices and versions as numbers in the same fields every time, at a fixed price per 1,000 results. AI agents can call it as a tool through Apify's MCP server. **Does it scrape reviews?** No. This Actor focuses on app data, charts and rankings, and does not collect reviewers' names or texts. **Why does a search return at most 30 apps?** That is how many apps Google Play shows for a keyword. For more apps of a category, use the top charts (up to 200 per chart). **What is `maxInstalls`?** Google Play shows installs in ranges such as "100,000,000+"; `maxInstalls` is Google's own, more precise install figure included in the page data. **Is it legal to scrape Google Play?** The Actor collects publicly available app listings. It does not collect reviews. For developer companies it returns the trader details Google itself shows under "App support" (legal name, address, phone, email); for individual developers these fields stay empty. Check the terms that apply to your use case. ### Integrations and API - **Google Sheets, Slack, email and BI tools**: connect the Actor to Make, Zapier or n8n, or use the **Integrations** tab of this Actor. Schedule it daily to track chart ranks, ratings and installs over time. - **Webhooks**: call your own URL when a run finishes, for example to load the results into your database. - **AI agents (MCP)**: add `https://mcp.apify.com?tools=robertosan16/google-play-scraper` as an MCP server in Claude, Cursor or VS Code, and your agent can look up apps, top charts and search rankings with this Actor. - **LangChain and LlamaIndex**: load app data into your LLM app with the Apify loaders. - **API**: one request runs the Actor and returns the apps, for runs of up to 5 minutes. Start longer runs with the `runs` endpoint and read the dataset when they finish. ```bash curl -X POST "https://api.apify.com/v2/acts/robertosan16~google-play-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"searchTerms":["habit tracker"],"countries":["US"],"maxItems":20}' ``` Missing a field or a feature? Open an issue in the Issues tab or email , and we will reply quickly. ### 中文简介 **Google Play 数据采集工具（Google Play 爬虫）**：抓取 Google Play（谷歌应用商店）任意国家和分类的**免费榜、付费榜和畅销榜**，每个榜单最多 200 名；按关键词抓取 Google Play **搜索排名**，用于 ASO 关键词排名追踪和竞品分析；获取应用详情：评分、评分分布、安装量、价格、内购价格区间、是否含广告、版本、更新日期、开发者邮箱和网站，以及一个开发者的全部应用。 适合应用出海、手游发行、ASO 优化、海外市场调研，以及通过开发者联系方式开发 B2B 客户。一次运行可以覆盖多个国家，支持 30 多种语言。无需浏览器、无需登录、无需谷歌 API 密钥。iOS 应用请使用字段相同的 [App Store Scraper](https://apify.com/robertosan16/app-store-scraper)。 价格：每 1,000 条结果 1.50 美元，无启动费；Apify 免费套餐每月约可获取 3,300 条结果。 结果可导出为 JSON、CSV、Excel 或 HTML，也可以通过 API、定时任务、Webhook 或 n8n、Make、Zapier 接入。有问题请在 Issues 页面提问，或发邮件至 support@mozartstandard.com。 # Actor input Schema ## `appIds` (type: `array`): Package names such as com.spotify.music or Google Play app links. ## `searchTerms` (type: `array`): Keywords to search on Google Play. Each search returns up to 30 apps with their rank, as the store shows them, which is useful for ASO keyword tracking. ## `charts` (type: `array`): Google Play top charts to scrape, with the rank of each app. ## `chartCategories` (type: `array`): Categories of the top charts. "All apps" and "All games" are the main charts. ## `chartDepth` (type: `integer`): How many places of each chart to scrape, from 1 to 200. ## `developers` (type: `array`): Developer names such as Spotify AB, numeric developer IDs or developer page links. All apps of each developer are scraped. ## `similarToAppIds` (type: `array`): Package names or app links, for example com.duolingo. The apps Google Play shows as similar to each of them are scraped (up to about 50 per app): a quick list of competitors. ## `countries` (type: `array`): Two-letter country codes such as US, GB, DE or JP. Prices, charts and search results differ by country. Every source is scraped for each country. ## `language` (type: `string`): Language of titles and descriptions where the developer provides translations. ## `includeDetails` (type: `boolean`): Open each app page for ratings count, rating histogram, exact installs, version, update date, developer contacts, screenshots and the full description. Turn off for fast, lightweight lists. ## `maxItems` (type: `integer`): Stop after this many results. Leave empty or 0 for no limit. ## `proxyConfiguration` (type: `object`): The Actor connects directly, which is fastest. If Google Play starts limiting requests, it switches to Apify Proxy automatically. Turn on a proxy here only to use it from the start. ## Actor input object example ```json { "searchTerms": [ "habit tracker" ], "charts": [ "topselling_free" ], "chartCategories": [ "APPLICATION" ], "chartDepth": 50, "countries": [ "US" ], "language": "en", "includeDetails": true, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `apps` (type: `string`): Apps with rank, rating, installs, price, category, dates, developer contacts and descriptions. ## `summary` (type: `string`): Apps found and saved for each search, chart, app and developer, with errors. # 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 = { "searchTerms": [ "habit tracker" ], "charts": [ "topselling_free" ], "chartCategories": [ "APPLICATION" ], "chartDepth": 50, "countries": [ "US" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("robertosan16/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 = { "searchTerms": ["habit tracker"], "charts": ["topselling_free"], "chartCategories": ["APPLICATION"], "chartDepth": 50, "countries": ["US"], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("robertosan16/google-play-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "habit tracker" ], "charts": [ "topselling_free" ], "chartCategories": [ "APPLICATION" ], "chartDepth": 50, "countries": [ "US" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call robertosan16/google-play-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,robertosan16/google-play-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/FPgPnid4ZggrEJEaY/builds/Dxf9EzaKa34ojrY0P/openapi.json