# 🤖 Google Play Scraper API | ASO, Keyword Search & App Data (`plum_spear/aztec-googleplay-aso`) Actor Search Google Play by keyword or look up apps by package name. Returns rating, installs, price, genre, developer, versions and metadata for Android app market research and ASO. - **URL**: https://apify.com/plum\_spear/aztec-googleplay-aso.md - **Developed by:** [Roberto Kerber](https://apify.com/plum_spear) (community) - **Categories:** Developer tools, SEO tools, Automation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.15 / 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. 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 - Android App Data, ASO & Keyword Research API Scrape **Google Play Store** app data at scale: search apps by keyword or look up any app by package name and get clean, structured JSON with **rating, ratings count, reviews, installs, price, genre, developer, release and update dates, version, content rating** and more. This **Google Play scraper** is built for **Android ASO (App Store Optimization)**, **Play Store keyword research**, and **Google Play competitor analysis**. No proxies, no account, no headless browser headaches - just reliable Android app metadata as a simple API. Run it once for a snapshot, or put it on a **schedule** to track installs, ratings, and keyword rankings as they change over time. Pair it with our **iOS App Store ASO scraper** for full cross-platform iOS + Android coverage. --- ### What does it do? This actor turns the Google Play Store into a structured **Android app data API**. Give it a keyword and it returns the ranking apps for that search, with all their metadata. Give it one or more package names (like `com.whatsapp`) and it returns the full profile of each app. Two simple modes cover every ASO and market research workflow: - **Search mode** - find the apps that rank for any keyword, exactly like a user searching the Play Store. Perfect for **Play Store keyword research** and discovering competitors. - **Lookup mode** - pull complete metadata for specific apps by package name. Perfect for **competitor tracking**, monitoring your own app, and building app databases. Every result comes back as clean JSON, ready to drop into a spreadsheet, dashboard, BI tool, or your own data pipeline. --- ### Features - 🔎 **Keyword search** - get the apps that rank for any term (e.g. "fitness tracker", "budget", "habit", a competitor's brand) - 🆔 **Package lookup** - fetch full metadata for any app by its Android package name - ⭐ **Rich metadata** - rating, total ratings, reviews count, installs, minInstalls, price, genre, developer, version, release & update dates, content rating - 📈 **Install counts** - get real **Google Play install data** (e.g. `10,000,000,000+`) for sizing markets and benchmarking competitors - 🌍 **Any country & language** - localize results to any Google Play storefront (US, UK, BR, DE, IN, and more) - 💵 **Free / paid detection** - price, currency, and a `free` boolean for monetization analysis - 🧱 **Clean JSON output** - flat, predictable fields ready for dashboards, BI, and ML pipelines - 🚫 **No proxy required** - runs reliably on the Apify cloud out of the box, no proxy configuration - 🔁 **Cross-platform ready** - combine with the iOS App Store ASO scraper for unified iOS + Android datasets --- ### Use cases #### ASO managers Run **Google Play ASO** workflows end to end: research which apps rank for your target keywords, benchmark their ratings and install counts, and spot gaps where you can outrank the competition. Track how your own app's rating and reviews evolve over time. #### App marketers Quantify a category before you spend a euro on user acquisition. See who dominates a keyword, how many installs the leaders have, and whether the niche is free-first or paid. Build competitor watchlists and refresh them on a schedule. #### Market researchers Turn the Play Store into a dataset. Measure category size, pricing distribution, developer concentration, and content ratings across hundreds of apps. Export to CSV/Excel/JSON for **Google Play competitor analysis** and trend reports. #### Indie Android developers Validate your app idea with real data. Find out how saturated a keyword is, what the top apps charge, and how big the install base really is - before you write a line of code. Monitor your competitors without checking the Play Store by hand. --- ### Automate it: scheduled monitoring App data is only useful if it's current. The real value of this **Google Play scraper** comes from running it on a recurring schedule and watching how installs, ratings, and keyword rankings move over time. Set it once and let it feed your dashboards automatically. #### Daily Android app data tracker Put the actor on a `@daily` schedule in `lookup` mode with a fixed list of `appIds` (your own app plus your top competitors). Each run captures `score`, `ratings`, `reviews`, `installs`, and `version`, so you build a day-by-day history of how every app is growing - no manual checking of the Play Store. #### Weekly Play Store keyword competition report Run the actor every week in `search` mode against the same target keyword. Because results come back in Play Store ranking order, you get a weekly snapshot of who ranks where, how their ratings and install counts are trending, and when a new competitor breaks into the top results for your **Play Store keyword research**. #### Category and pricing monitor Schedule `search` mode across a set of category keywords to track how pricing, free/paid mix, and developer concentration shift in a niche over weeks and months - ideal for ongoing **Google Play competitor analysis** and market-entry timing. #### How to set it up 1. Open the actor and click **Schedule** (or use the **Apify Scheduler** from the console). 2. Pick a cron expression for how often it should run - for example `0 8 * * *` for every day at 08:00 UTC, or `0 8 * * 1` for every Monday morning. 3. Save your input (mode, `term` or `appIds`, `country`, `language`) so every scheduled run uses the same configuration. 4. Wire the output to wherever you want it: connect **Make**, **Zapier**, or **n8n** to the Apify integration and push each run's dataset into **Google Sheets**, **Slack**, or **email** - so a fresh report lands automatically without anyone hitting "Run". This turns a one-off scrape into an always-on Android app monitoring pipeline. --- ### Input Configure the run with a few simple fields: | Field | Type | Description | Example | |-------|------|-------------|---------| | `mode` | string | `search` (apps by keyword) or `lookup` (apps by package name) | `search` | | `term` | string | Keyword to search for (used in `search` mode) | `fitness tracker` | | `appIds` | array | Android package names to look up (used in `lookup` mode) | `["com.whatsapp", "com.spotify.music"]` | | `country` | string | Two-letter country code for the storefront | `us`, `gb`, `br`, `de` | | `language` | string | Two-letter language code for localized results | `en`, `pt`, `de` | | `maxResults` | integer | Max apps to return in `search` mode (up to 30) | `30` | #### Example input - keyword search ```json { "mode": "search", "term": "fitness tracker", "country": "us", "language": "en", "maxResults": 30 } ```` #### Example input - package lookup ```json { "mode": "lookup", "appIds": ["com.whatsapp", "com.spotify.music"], "country": "us", "language": "en" } ``` *** ### Example output Here is a real lookup result for WhatsApp Messenger (`com.whatsapp`): ```json { "appId": "com.whatsapp", "title": "WhatsApp Messenger", "score": 4.66, "ratings": 237058214, "reviews": 1962977, "installs": "10,000,000,000+", "minInstalls": 10000000000, "price": 0, "free": true, "currency": "USD", "genre": "Communication", "developer": "WhatsApp LLC", "released": "Oct 18, 2010", "updated": "Jun 10, 2026", "version": "Varies with device", "contentRating": "Everyone", "adSupported": false, "summary": "Simple. Reliable. Private. Message and call for free.", "descriptionPreview": "WhatsApp from Meta is a free messaging and video calling app...", "icon": "https://play-lh.googleusercontent.com/.../icon.png", "url": "https://play.google.com/store/apps/details?id=com.whatsapp" } ``` In `search` mode you get an array of apps, each with a lighter subset of these fields, ordered the way the Play Store ranks them for your keyword. *** ### Output fields Every app can include the following fields: | Field | Description | |-------|-------------| | `appId` | Android package name (unique app identifier) | | `title` | App display name | | `score` | Average star rating (0-5) | | `ratings` | Total number of star ratings | | `reviews` | Number of written reviews | | `installs` | Human-readable install count (e.g. `10,000,000,000+`) | | `minInstalls` | Minimum installs as an integer (for sorting/filtering) | | `price` | Price as a number (`0` for free apps) | | `free` | Boolean - whether the app is free | | `currency` | Currency code for the price | | `genre` | Primary category / genre | | `developer` | Developer or publisher name | | `released` | Original release date | | `updated` | Last update date | | `version` | Current app version | | `contentRating` | Content rating (e.g. `Everyone`, `Teen`) | | `adSupported` | Boolean - whether the app shows ads | | `summary` | Short tagline / summary | | `descriptionPreview` | Beginning of the full app description | | `icon` | URL of the app icon | | `url` | Direct Google Play Store URL | Search mode returns a lighter subset of these fields for each app; lookup mode returns the full set. *** ### FAQ #### How do I scrape Google Play app data? Set `mode` to `lookup` and pass the app package names in `appIds` (for example `["com.whatsapp"]`), or set `mode` to `search` with a `term` to get every app ranking for a keyword. Run the actor and you get structured JSON for each app - title, rating, installs, price, developer, and more. No coding, proxies, or Google account required. #### Can I get install counts from Google Play? Yes. Every result includes `installs` as a human-readable string (e.g. `10,000,000,000+`) and `minInstalls` as an integer you can sort and filter on. This is ideal for sizing a market and benchmarking competitors with real **Google Play install data**. #### How do I do Play Store keyword research? Use `search` mode with your target keyword in `term`. The actor returns the apps that rank for that keyword in the order the Play Store shows them, along with their ratings and install counts - so you can see exactly how competitive a keyword is and who you are up against. #### Does this work for any country or language? Yes. Set `country` (two-letter code like `us`, `gb`, `br`, `de`) and `language` (two-letter code like `en`, `pt`, `de`) to localize results to any Google Play storefront. This is essential for international **Google Play ASO** and market entry research. #### Do I need a proxy or a Google account? No. This Google Play scraper runs reliably on the Apify cloud with no proxy configuration and no login. Just provide your input and run it. #### Can I run this on a schedule? Yes, and it's where this actor shines. Use the **Apify Scheduler** to run it automatically on any cron schedule - for example `0 8 * * *` for a daily app data snapshot or `0 8 * * 1` for a weekly keyword report. Connect **Make**, **Zapier**, or **n8n** to deliver each run straight to **Google Sheets**, **Slack**, or **email**, so you track installs, ratings, and Play Store rankings over time with no manual runs. #### How is this different from the iOS App Store scraper? This actor covers **Android app metadata** from the Google Play Store. For full cross-platform coverage, pair it with the iOS App Store ASO scraper so you have one consistent dataset across both Google Play and the Apple App Store. #### What can I do with the output? Export it to CSV, Excel, or JSON, push it into a Google Sheet, a BI dashboard, or your own data pipeline via the Apify API. Common uses are **Google Play competitor analysis**, ASO keyword tracking, market sizing, and lead lists of apps and developers in a niche. #### Is there a free tier? Apify gives every new account free monthly platform credits, so you can run this actor and test it at no cost before scaling up. After that you only pay per event as described below. *** ### Pricing This actor uses **pay-per-event** pricing: **$0.15 per 1,000 results returned, plus a minimal actor-start event**. No subscription, no monthly minimums - you only pay for the app records you actually get. New Apify accounts also include free monthly credits, so you can start testing right away. *** ### Get started 1. Set `mode` to `search` or `lookup`. 2. Add a `term` (search) or `appIds` (lookup), plus optional `country` and `language`. 3. Run the actor and grab your structured Android app data as JSON, CSV, or Excel. For full cross-platform **ASO** coverage across iOS and Android, run this alongside the App Store ASO scraper and merge the results into a single dataset. # Actor input Schema ## `mode` (type: `string`): search = find apps by keyword; lookup = get apps by package name. ## `term` (type: `string`): Keyword to search for, e.g. 'fitness', 'budget app', a competitor name. ## `appIds` (type: `array`): Google Play package names, e.g. com.whatsapp, com.spotify.music. ## `country` (type: `string`): Two-letter Google Play country (us, gb, br, de, ...). ## `language` (type: `string`): Two-letter language code (en, pt, de, ...). ## `maxResults` (type: `integer`): Maximum number of results (search returns up to 30). ## Actor input object example ```json { "mode": "search", "country": "us", "language": "en", "maxResults": 30 } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("plum_spear/aztec-googleplay-aso").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 = {} # Run the Actor and wait for it to finish run = client.actor("plum_spear/aztec-googleplay-aso").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 '{}' | apify call plum_spear/aztec-googleplay-aso --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=plum_spear/aztec-googleplay-aso", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "🤖 Google Play Scraper API | ASO, Keyword Search & App Data", "description": "Search Google Play by keyword or look up apps by package name. Returns rating, installs, price, genre, developer, versions and metadata for Android app market research and ASO.", "version": "0.1", "x-build-id": "h9A3pcYq3ZZpeisqd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plum_spear~aztec-googleplay-aso/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plum_spear-aztec-googleplay-aso", "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/plum_spear~aztec-googleplay-aso/runs": { "post": { "operationId": "runs-sync-plum_spear-aztec-googleplay-aso", "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/plum_spear~aztec-googleplay-aso/run-sync": { "post": { "operationId": "run-sync-plum_spear-aztec-googleplay-aso", "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": "Mode", "enum": [ "search", "lookup" ], "type": "string", "description": "search = find apps by keyword; lookup = get apps by package name.", "default": "search" }, "term": { "title": "Search term (search mode)", "type": "string", "description": "Keyword to search for, e.g. 'fitness', 'budget app', a competitor name." }, "appIds": { "title": "Package names (lookup mode)", "type": "array", "description": "Google Play package names, e.g. com.whatsapp, com.spotify.music.", "items": { "type": "string" } }, "country": { "title": "Country code", "type": "string", "description": "Two-letter Google Play country (us, gb, br, de, ...).", "default": "us" }, "language": { "title": "Language code", "type": "string", "description": "Two-letter language code (en, pt, de, ...).", "default": "en" }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of results (search returns up to 30).", "default": 30 } } }, "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 } } } } } } } } } } ```