# Xiaomi Mi App Store Scraper (`unfenced-group/xiaomi-app-store-scraper`) Actor Extract app listings and full metadata from the Xiaomi Mi App Store - both the Chinese store (app.mi.com) and the global store. Names, developers, ratings, per-region ratings, download counts, descriptions, changelogs, screenshots, permissions, version and category. - **URL**: https://apify.com/unfenced-group/xiaomi-app-store-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 33.3% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.86 / 1,000 app listings 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Xiaomi Mi App Store Scraper ![Xiaomi Mi App Store Scraper](https://api.apify.com/v2/key-value-stores/mGsqBsma9DoLVlKuG/records/banner.png) Extract app listings and full app metadata from the Xiaomi Mi App Store — names, developers, ratings, per-region rating breakdowns, download counts, descriptions, changelogs, screenshots, permissions, version, size and category — from both the Chinese store (app.mi.com) and the global store (global.app.mi.com). No API key required. --- ### Why this scraper? #### 🎯 The complete app record Not just the search-card basics. With detail enrichment on, every app comes back with its full description, changelog, screenshots, requested permissions, developer, update date and privacy policy URL. #### 🇨🇳 🌍 Both Mi App Stores Browse the Chinese store by category, look up keyword suggestions, or fetch any app by package name. The global store returns localised metadata — including a real download count — for any package name you pass. #### 🗂️ Category browse and direct lookup Sweep an entire Chinese-store category, resolve keyword suggestions, or fetch specific apps directly by their Android package name. Mix all three in a single run. #### ⭐ Ratings and market signals Average rating, total rating count, a per-region rating breakdown (CN/HK/TW/IN/RU/ID) and — on the global store — the exact download count. The signals you need for market and competitor research. #### 🧾 Clean, structured output One flat record per app, every field always present and `null` when the store does not publish it. Ready for a spreadsheet, a database or an ML pipeline. --- ### Input parameters | Parameter | Type | Default | Description | |---|---|---|---| | `store` | string | `"cn"` | Which store to scrape: `cn` (app.mi.com, full discovery) or `global` (global.app.mi.com, by package name). | | `categoryIds` | array | `[]` | Chinese-store category IDs to browse (e.g. `15`=Games, `8`=Communication). Ignored when `store=global`. | | `searchQueries` | array | `[]` | Keywords to resolve to Mi App Store search suggestions (CN store). Ignored when `store=global`. | | `packageNames` | array | `[]` | Android package names to fetch full detail for (e.g. `com.tencent.mm`). Works for both stores; the only discovery mode for `global`. | | `globalLocale` | string | `"ID"` | Country code (`lo`) for the global store, e.g. `ID`, `IN`, `RU`. Only used when `store=global`. | | `globalLanguage` | string | `"en"` | Language code (`la`) for the global store, e.g. `en`, `ru`, `id`. Only used when `store=global`. | | `maxItemsPerQuery` | integer | `100` | Max apps per category browse. Set to `0` for unlimited. | | `fetchDetails` | boolean | `true` | Enrich each app with detail-page fields. Disable for a faster, lighter run. | #### Chinese-store category IDs `15` Games · `2` Video & Audio · `5` System Tools · `8` Communication · `9` Photography · `10` Lifestyle · `11` Shopping · `12` News & Reading · `19` Education · `20` Health · `23` Travel & Navigation · `27` Parenting --- ### Output schema Every field below is present on every record. Fields the store does not publish for a given app are returned as `null` rather than omitted. #### Always present | Field | Type | Description | |---|---|---| | `store` | string | `cn` or `global`. | | `appId` | number\|null | Numeric Mi App Store app ID (CN store). | | `packageName` | string\|null | Android package name (e.g. `com.tencent.mm`). | | `name` | string | App display name. | | `developerId` | number\|null | Numeric developer ID (CN store). | | `developer` | string\|null | Developer or publisher name. | | `category` | string\|null | Primary category. | | `subCategory` | string\|null | Secondary category (CN store). | | `categoryId` | number\|null | Numeric category ID (CN store). | | `brief` | string\|null | Short tagline shown on the card (CN store). | | `rating` | number\|null | Average rating. | | `ratingCount` | number\|null | Total number of ratings. | | `ratingByRegion` | object\|null | Per-region rating map, e.g. `{ "CN": 3.4, "ID": 4.8 }`. | | `downloadCount` | number\|null | Exact install count (global store). | | `iconUrl` | string\|null | App icon image URL. | | `sizeBytes` | number\|null | Package size in bytes. | | `size` | string\|null | Human-readable package size (e.g. `1829.53M`). | | `versionName` | string\|null | Version label (e.g. `11.4.1.1`). | | `versionCode` | number\|null | Internal version code. | | `apkPath` | string\|null | APK storage path fragment (CN store). | | `updateTime` | string\|null | Last-update timestamp (ISO) where published as epoch. | | `storeUrl` | string\|null | Public detail page URL. | | `searchKeyword` | string\|null | Keyword that surfaced this record (`null` for direct lookups). | | `contentHash` | string | Stable 16-char fingerprint of the record. | | `source` | string | Always `xiaomi-app-store`. | | `scrapedAt` | string | ISO timestamp of capture. | #### With `fetchDetails: true` | Field | Type | Description | |---|---|---| | `introduction` | string\|null | Full app description as plain text. | | `changeLog` | string\|null | "What's new" / changelog text. | | `screenshots` | array\|null | Screenshot image URLs. | | `permissions` | array\|null | Requested app permissions (CN store). | | `privacyPolicyUrl` | string\|null | Developer privacy policy URL (CN store). | | `updateDate` | string\|null | Update date as published on the detail page (CN store). | #### Example record ```json { "store": "cn", "appId": 108048, "packageName": "com.tencent.tmgp.sgame", "name": "王者荣耀", "developerId": 237950, "developer": "深圳市腾讯计算机系统有限公司", "category": "网游RPG", "subCategory": "网游RPG", "categoryId": 15, "brief": "全新赛季现已上线！", "rating": 7.0, "ratingCount": 416387, "ratingByRegion": { "CN": 3.4 }, "downloadCount": null, "iconUrl": "http://file.market.xiaomi.com/thumbnail/PNG/l62/AppStore/0af7...", "sizeBytes": 1918398, "size": "1829.53M", "versionName": "11.4.1.1", "versionCode": null, "apkPath": "AppStore/059d5b54...", "updateTime": null, "storeUrl": "https://app.mi.com/details?id=com.tencent.tmgp.sgame", "searchKeyword": null, "introduction": "《王者荣耀》是腾讯第一5V5团队公平竞技手游...", "changeLog": "【版本更新内容】1.新赛季...", "screenshots": ["http://file.market.xiaomi.com/thumbnail/jpeg/l395/AppStore/..."], "permissions": ["获取网络状态", "读取手机状态"], "privacyPolicyUrl": null, "updateDate": "2026-06-25", "contentHash": "a1b2c3d4e5f60718", "source": "xiaomi-app-store", "scrapedAt": "2026-07-18T09:15:00.000Z" } ```` *** ### Examples **Browse the entire Games category (CN store) with full details:** ```json { "store": "cn", "categoryIds": ["15"], "maxItemsPerQuery": 200, "fetchDetails": true } ``` **Fast category sweep without detail enrichment:** ```json { "store": "cn", "categoryIds": ["8", "9"], "maxItemsPerQuery": 300, "fetchDetails": false } ``` **Look up specific apps by package name (CN store):** ```json { "store": "cn", "packageNames": ["com.tencent.mm", "com.shenlan.m.reverse1999.mi"], "fetchDetails": true } ``` **Global store — full metadata for apps in Indonesia:** ```json { "store": "global", "packageNames": ["com.whatsapp", "com.instagram.android"], "globalLocale": "ID", "globalLanguage": "en" } ``` *** ### 💰 Pricing Pay-per-result — you only pay for successfully retrieved apps. Failed retries are never charged. - **$0.99 per 1,000 apps** for listing records. - **$1.99 per 1,000 apps** additional when full details are fetched (`fetchDetails: true`) — the full description, changelog, screenshots and permissions. Turn `fetchDetails` off for listing-only records at the lower rate. *** ### Performance | Run size | Typical time | |---|---| | 100 apps (details on) | 1–3 minutes | | 300 apps (details on) | 5–9 minutes | | 300 apps (details off) | under 1 minute | Detail enrichment fetches one extra request per app. Turn it off for the fastest catalog sweeps. *** ### Known limitations - **Global discovery is by package name.** The global store's browse and search pages are client-rendered, so category browse works on the Chinese store only. Supply package names to pull global records. - **CN keyword search returns suggestions, not full apps.** The Chinese store's suggestion endpoint returns app-name leads; feed those names or their package names back in for full records. - **Some fields depend on the store and developer.** Download count is a global-store field; permissions and privacy policy are Chinese-store detail fields; both are `null` where not published. - **Chinese-store metadata is in Chinese.** Names, categories and descriptions come back as published — in Chinese for the CN store, localised for the global store. *** ### Technical details - **Source:** Xiaomi Mi App Store — app.mi.com (China) and global.app.mi.com (international) - **Coverage:** category browse, keyword suggestions and direct package-name lookup - **Retry:** automatic retry on network errors with exponential backoff *** ### Rate this actor If this scraper does its job, a short review on the **Reviews** tab helps other users find it. Something not working? Open an issue on the **Issues** tab instead — issues get fixed. *** ### Need a custom scraper? **[Unfenced Group](https://www.unfencedgroup.nl)** builds Apify actors for any website — for free. If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio. **Get in touch:** [www.unfencedgroup.nl](https://www.unfencedgroup.nl) # Actor input Schema ## `store` (type: `string`): Which Mi App Store to scrape. 'cn' is the Chinese store (app.mi.com) with full category browse, keyword suggestions and detail enrichment. 'global' is the international store (global.app.mi.com), which supports detail lookup by package name only. ## `categoryIds` (type: `array`): Chinese-store category IDs to browse. Common IDs: 15=Games, 2=Video & Audio, 5=System Tools, 8=Communication, 9=Photography, 10=Lifestyle, 11=Shopping, 12=News & Reading, 19=Education, 20=Health, 23=Travel, 27=Parenting. Ignored when store=global. ## `searchQueries` (type: `array`): Keywords to look up in the Chinese store. Returns Mi App Store search suggestions for each keyword as lead records. Ignored when store=global. ## `packageNames` (type: `array`): Android package names to fetch full app detail for (e.g. com.tencent.mm). Works for both stores. This is the only discovery mode for store=global. ## `globalLocale` (type: `string`): Country code passed as the 'lo' parameter to the global store, e.g. ID (Indonesia), IN (India), RU (Russia). Only used when store=global. ## `globalLanguage` (type: `string`): Language code passed as the 'la' parameter to the global store, e.g. en, ru, id. Only used when store=global. ## `maxItemsPerQuery` (type: `integer`): Maximum apps to collect per category browse. Use 0 for unlimited (collect the whole category). ## `fetchDetails` (type: `boolean`): When true, each app is enriched with its detail page (full description, screenshots, permissions, version, developer, update date, privacy policy). When false, only listing fields are returned (faster, cheaper). ## `proxyConfiguration` (type: `object`): Optional proxy. Not required — the Mi App Store serves from datacenter IPs without anti-bot challenge. Supply a proxy only if you need geo-specific routing. ## Actor input object example ```json { "store": "cn", "categoryIds": [ "15", "8" ], "searchQueries": [ "游戏", "微信" ], "packageNames": [ "com.tencent.mm", "com.shenlan.m.reverse1999.mi" ], "globalLocale": "ID", "globalLanguage": "en", "maxItemsPerQuery": 100, "fetchDetails": true, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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("unfenced-group/xiaomi-app-store-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 = {} # Run the Actor and wait for it to finish run = client.actor("unfenced-group/xiaomi-app-store-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 '{}' | apify call unfenced-group/xiaomi-app-store-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/xiaomi-app-store-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Xiaomi Mi App Store Scraper", "description": "Extract app listings and full metadata from the Xiaomi Mi App Store - both the Chinese store (app.mi.com) and the global store. Names, developers, ratings, per-region ratings, download counts, descriptions, changelogs, screenshots, permissions, version and category.", "version": "0.0", "x-build-id": "yf7hpFjwEpkjPuosq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~xiaomi-app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-xiaomi-app-store-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/unfenced-group~xiaomi-app-store-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-xiaomi-app-store-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/unfenced-group~xiaomi-app-store-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-xiaomi-app-store-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": { "store": { "title": "Store", "enum": [ "cn", "global" ], "type": "string", "description": "Which Mi App Store to scrape. 'cn' is the Chinese store (app.mi.com) with full category browse, keyword suggestions and detail enrichment. 'global' is the international store (global.app.mi.com), which supports detail lookup by package name only.", "default": "cn" }, "categoryIds": { "title": "Category IDs (CN store)", "type": "array", "description": "Chinese-store category IDs to browse. Common IDs: 15=Games, 2=Video & Audio, 5=System Tools, 8=Communication, 9=Photography, 10=Lifestyle, 11=Shopping, 12=News & Reading, 19=Education, 20=Health, 23=Travel, 27=Parenting. Ignored when store=global.", "default": [], "items": { "type": "string" } }, "searchQueries": { "title": "Search keywords (CN store)", "type": "array", "description": "Keywords to look up in the Chinese store. Returns Mi App Store search suggestions for each keyword as lead records. Ignored when store=global.", "default": [], "items": { "type": "string" } }, "packageNames": { "title": "Package names", "type": "array", "description": "Android package names to fetch full app detail for (e.g. com.tencent.mm). Works for both stores. This is the only discovery mode for store=global.", "default": [], "items": { "type": "string" } }, "globalLocale": { "title": "Global locale (country)", "type": "string", "description": "Country code passed as the 'lo' parameter to the global store, e.g. ID (Indonesia), IN (India), RU (Russia). Only used when store=global.", "default": "ID" }, "globalLanguage": { "title": "Global language", "type": "string", "description": "Language code passed as the 'la' parameter to the global store, e.g. en, ru, id. Only used when store=global.", "default": "en" }, "maxItemsPerQuery": { "title": "Max items per query", "minimum": 0, "type": "integer", "description": "Maximum apps to collect per category browse. Use 0 for unlimited (collect the whole category).", "default": 100 }, "fetchDetails": { "title": "Fetch full app details", "type": "boolean", "description": "When true, each app is enriched with its detail page (full description, screenshots, permissions, version, developer, update date, privacy policy). When false, only listing fields are returned (faster, cheaper).", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy. Not required — the Mi App Store serves from datacenter IPs without anti-bot challenge. Supply a proxy only if you need geo-specific routing.", "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 } } }, "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 } } } } } } } } } } ```