# Google Play App Scraper (`taroyamada/google-play-intelligence`) Actor Scrape Google Play app metadata, ratings, install ranges, pricing, and version changes for ASO tracking and Android competitor research. - **URL**: https://apify.com/taroyamada/google-play-intelligence.md - **Developed by:** [太郎 山田](https://apify.com/taroyamada) (community) - **Categories:** Marketing, SEO tools, Games - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $9.00 / 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 Intelligence API | App Metadata, Ratings & Review Samples Monitor specific Android applications on the Google Play store using a highly efficient, browserless data extractor. Designed for recurring watchlists and automated alerts, this tool captures precise app metadata, install ranges, pricing flags, and public review snippets directly from storefront listings. Rather than relying on heavy, resource-intensive browser rendering, it leverages a lightweight approach to instantly retrieve normalized metrics. This makes it the perfect solution for teams tracking mobile market trends, analyzing App Store Optimization (ASO) performance, or keeping a close eye on competitor app updates across different global regions. Set up automated daily runs to maintain an accurate baseline of your top competitors or track your own app's visibility in the search results. The extractor outputs structured JSON containing developer contact details, updated descriptions, screenshot URLs, and crucial rating distribution data. Because it runs quickly and reliably, you can easily route the scraped data payload via webhooks to trigger immediate Slack or email notifications—such as alerting your product team the moment a competitor launches a new feature or when an app's average rating experiences a sudden drop. Whether you are managing a massive portfolio of mobile games or tracking a niche utility, this focused storefront tool delivers clean, actionable intelligence without the complexity of cross-platform monitoring setups. ### Store Quickstart - Start with `store-input.example.json` for the smallest useful dataset run. - Check `sample-output.example.json` for a recent Google Play sample captured from the repo's live output. - Check `live-proof.example.json` for the latest live canary + contract proof on the public actor surface. - Then move through `store-input.templates.json` in this order: - `Quickstart Baseline (2 Apps)` — smallest useful dataset run - `Recurring Baseline (Mobile App Watchlist)` — same country/language baseline tuned for repeat monitoring - `Webhook Routed Alerts (Rating Drop Handoff)` — route the same payload after the dataset baseline is stable - Keep `country` and `language` pinned from the start so repeat runs stay comparable. ### What it does For each Google Play app source, the actor: 1. Normalizes package IDs and Google Play listing URLs. 2. Fetches the public listing page with polite headers and timeouts. 3. Extracts metadata from JSON-LD, canonical/meta tags, visible HTML, and Google Play embedded state. 4. Returns normalized app intelligence including title, developer, category, icon, screenshots, rating, rating count, install ranges, pricing flags, content rating, descriptions, and update dates. 5. Samples public review rows only when Google Play embeds them in the initial HTML response. 6. Emits explicit warnings when a field or review surface is unavailable instead of fabricating data. ### Data strategy This actor intentionally avoids browser automation, authenticated traffic, and private APIs. Extraction tiers: 1. **JSON-LD** — stable core app metadata. 2. **Canonical/meta tags** — URL and description fallbacks. 3. **Embedded `AF_initDataCallback` state** — installs, screenshots, developer metadata, rating breakdowns, and occasional review samples. 4. **Visible HTML labels** — final fallback for fields like `Updated on`. ### Limitations - Google Play does **not** reliably expose the current version on every public listing response. The actor returns `null` and a warning when it cannot confirm it. - Review output is limited to the review snippets that Google Play embeds in the initial HTML. If Google stops embedding them, the actor falls back to aggregate rating data only. - Availability can vary by storefront. If an app is missing or geo-restricted for the requested country, the actor returns a structured warning or missing status. ### Use Cases | Who | Why | |---|---| | **ASO teams** | Compare category fit, installs, ratings, and screenshots across Android competitors | | **Product teams** | Sample public complaints after releases without running a full review-mining stack | | **Growth teams** | Benchmark storefront positioning across markets with pinned country/language settings | | **Support teams** | Watch for repeated issue themes in public review snippets | ### Input | Field | Type | Default | Description | |---|---|---:|---| | `appUrls` | `string[]` | required | Google Play URLs or Android package IDs | | `country` | `string` | `"us"` | Two-letter storefront code | | `language` | `string` | `"en"` | Listing page language | | `reviewLimit` | `integer` | `20` | Max embedded public review samples per app | | `timeoutMs` | `integer` | `20000` | HTTP timeout per request | | `delivery` | `string` | `"dataset"` | `dataset` or `webhook` | | `webhookUrl` | `string` | — | Webhook destination when delivery=`webhook` | | `dryRun` | `boolean` | `false` | Skip dataset writes | ### Output Each row in `apps` includes: - `status`: `ok`, `partial`, `missing`, `blocked`, `invalid`, or `error` - `app`: normalized listing intelligence - `reviewIntelligence`: aggregate review availability plus public sample rows when exposed - `warnings`: explicit structured warnings with `code` and `message` - `fetch`: requested URL, final URL, and HTTP status #### Output Example ```json { "meta": { "implementationStatus": "partial", "totalSources": 2, "uniquePackages": 2, "totals": { "apps": 2, "ok": 1, "partial": 0, "missing": 1, "blocked": 0, "invalid": 0, "errors": 0, "warnings": 3, "totalReviewSamples": 5 } }, "apps": [ { "packageId": "com.spotify.music", "status": "ok", "app": { "title": "Spotify: Music and Podcasts", "developer": "Spotify AB", "rating": 4.3, "ratingCount": 35383844, "installsText": "1,000,000,000+", "contentRating": "Teen" }, "reviewIntelligence": { "availability": "sampled_public_html", "sampleCount": 5, "fullReviewCoverageAvailable": false } } ] } ```` ### Local run ```bash npm start npm test ``` `npm start` reads `input.json` locally and writes `output/result.json`. ### Related Actors Use this actor first for Android-only watchlists, storefront checks, or lightweight Play review sampling. Add the next actor when you need the adjacent signal: - [App Review Intelligence API | App Store + Google Play Summary](https://apify.com/taroyamada/app-review-cross-platform-intelligence) — Promote to this once stakeholders want one summary row across iOS and Android instead of separate store reports. - [Apple App Store Intelligence API](https://apify.com/taroyamada/apple-app-store-intelligence) — Add when the same launch or competitor set needs iOS-side metadata, pricing, and deeper public review sampling. - [Shopify Store Intelligence API](https://apify.com/taroyamada/shopify-store-intelligence) — Add when the app belongs to a commerce brand and you want to connect Play feedback with storefront or catalog changes. - [Domain Security Audit API](https://apify.com/taroyamada/domain-trust-monitor) — Add when Android complaints mention sign-in, payments, or site trust and you need to audit owned web properties. ### Pricing & Cost Control Apify Store pricing is usage-based, so total cost mainly follows how many `appUrls` you process and how many review samples you request. Check the Store pricing card for the current per-event rates. - Start with `Quickstart Baseline` on 1–3 package IDs or listing URLs in dataset mode. - Keep `reviewLimit` around 10–20 for `Recurring Baseline`, and pin `country` / `language` so repeat runs stay comparable. - Use `Webhook Routed Alerts` only after the dataset baseline already matches your warning flow. - Use `dryRun: true` before scheduled runs or webhook delivery. ### ⭐ Was this helpful? If this actor saved you time, please [**leave a ★ rating**](https://apify.com/taroyamada/google-play-intelligence/reviews) on Apify Store. It takes 10 seconds, helps other developers discover it, and keeps updates free. Bug report or feature request? Open an issue on the [Issues tab](https://apify.com/taroyamada/google-play-intelligence/issues) of this actor. # Actor input Schema ## `appUrls` (type: `array`): Google Play app URLs or Android package identifiers to inspect. ## `country` (type: `string`): Two-letter Google Play storefront code used for listing requests. ## `language` (type: `string`): Language code used for listing requests. ## `reviewLimit` (type: `integer`): Maximum embedded public review samples to keep per app. Set to 0 to skip review samples. ## `timeoutMs` (type: `integer`): HTTP timeout per Google Play listing request. ## `delivery` (type: `string`): Where to send results: dataset or webhook. ## `webhookUrl` (type: `string`): Webhook URL to POST results to when delivery=webhook. ## `dryRun` (type: `boolean`): Run extraction without pushing rows to the dataset. ## Actor input object example ```json { "appUrls": [ "com.spotify.music", "https://play.google.com/store/apps/details?id=com.duolingo" ], "country": "us", "language": "en", "reviewLimit": 20, "timeoutMs": 20000, "delivery": "dataset", "dryRun": false } ``` # 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 = { "appUrls": [ "com.spotify.music", "https://play.google.com/store/apps/details?id=com.duolingo" ] }; // Run the Actor and wait for it to finish const run = await client.actor("taroyamada/google-play-intelligence").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 = { "appUrls": [ "com.spotify.music", "https://play.google.com/store/apps/details?id=com.duolingo", ] } # Run the Actor and wait for it to finish run = client.actor("taroyamada/google-play-intelligence").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 '{ "appUrls": [ "com.spotify.music", "https://play.google.com/store/apps/details?id=com.duolingo" ] }' | apify call taroyamada/google-play-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=taroyamada/google-play-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Play App Scraper", "description": "Scrape Google Play app metadata, ratings, install ranges, pricing, and version changes for ASO tracking and Android competitor research.", "version": "0.1", "x-build-id": "z3EDrWkfMOVWc3QAs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/taroyamada~google-play-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-taroyamada-google-play-intelligence", "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/taroyamada~google-play-intelligence/runs": { "post": { "operationId": "runs-sync-taroyamada-google-play-intelligence", "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/taroyamada~google-play-intelligence/run-sync": { "post": { "operationId": "run-sync-taroyamada-google-play-intelligence", "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": [ "appUrls" ], "properties": { "appUrls": { "title": "App URLs or package IDs", "type": "array", "description": "Google Play app URLs or Android package identifiers to inspect.", "items": { "type": "string" } }, "country": { "title": "Storefront country", "minLength": 2, "type": "string", "description": "Two-letter Google Play storefront code used for listing requests.", "default": "us" }, "language": { "title": "Language", "minLength": 2, "type": "string", "description": "Language code used for listing requests.", "default": "en" }, "reviewLimit": { "title": "Embedded review sample limit", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum embedded public review samples to keep per app. Set to 0 to skip review samples.", "default": 20 }, "timeoutMs": { "title": "Request timeout (ms)", "minimum": 5000, "maximum": 60000, "type": "integer", "description": "HTTP timeout per Google Play listing request.", "default": 20000 }, "delivery": { "title": "Delivery", "enum": [ "dataset", "webhook" ], "type": "string", "description": "Where to send results: dataset or webhook.", "default": "dataset" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Webhook URL to POST results to when delivery=webhook." }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Run extraction without pushing rows to the dataset.", "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 } } }, "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 } } } } } } } } } } ```