# Huawei AppGallery Scraper (`unfenced-group/huawei-appgallery-scraper`) Actor Extract app listings and full metadata from Huawei AppGallery: descriptions, ratings, downloads, screenshots, permissions, version, size, developer and category. Search or App ID lookup across EU, Singapore, Russia and China. No API key. - **URL**: https://apify.com/unfenced-group/huawei-appgallery-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** E-commerce, Developer tools, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $4.35 / 1,000 app (full detail)s 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 ## Huawei AppGallery Scraper ![Huawei AppGallery Scraper](https://api.apify.com/v2/key-value-stores/ozY2e55gkuzpJNRy6/records/banner.png) Extract app listings and full app metadata from the Huawei AppGallery at scale โ€” descriptions, ratings, download labels, screenshots, permissions, version, size, developer and category โ€” across the Europe, Singapore, Russia and China catalogs. 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, release date, screenshots, requested permissions, content rating and privacy policy URL. #### ๐ŸŒ Four regional catalogs Europe, Singapore, Russia and China each expose a different app catalog. Pick the region and locale you need; metadata comes back localised. #### ๐Ÿ”Ž Search or direct lookup Search the catalog by keyword, or fetch specific apps directly by their AppGallery App ID. Mix both in a single run. #### โญ Ratings and market signals Star rating, rating count, download-count label and free/paid status on every record โ€” 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 | |---|---|---|---| | `searchQueries` | array | `[]` | Keywords to search the catalog for. AppGallery matches closely, so use real app names where possible. | | `appIds` | array | `[]` | Specific AppGallery App IDs to fetch directly (e.g. `C100495631`). Use with or instead of `searchQueries`. | | `region` | string | `"europe"` | Catalog to query: `europe`, `singapore`, `russia` or `china`. | | `locale` | string | `"en_US"` | Locale for names, categories and descriptions (e.g. `en_US`, `de_DE`, `fr_FR`). | | `maxItemsPerQuery` | integer | `100` | Max apps per keyword. Set to `0` for unlimited. Ignored for App ID lookups. | | `fetchDetails` | boolean | `true` | Enrich each app with detail-page fields. Disable for a faster, lighter run. | --- ### 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 (search and lookup) | Field | Type | Description | |---|---|---| | `appId` | string | AppGallery app identifier (e.g. `C100495631`). | | `packageName` | string\|null | Android/HarmonyOS package name (e.g. `com.whatsapp`). | | `name` | string | App display name. | | `developer` | string\|null | Developer or publisher name. | | `category` | string\|null | App category / tag. | | `briefDescription` | string\|null | Short tagline or summary shown on the search card. | | `rating` | number\|null | Average star rating (0โ€“5). | | `downloadCountLabel` | string\|null | Human-readable install count (e.g. `500M+`). | | `price` | string\|null | Price string, `null` for free apps. | | `isFree` | boolean | Whether the app is free. | | `size` | string\|null | Human-readable package size (e.g. `42.3 MB`). | | `sizeBytes` | number\|null | Package size in bytes. | | `versionName` | string\|null | Version label (e.g. `2.24.5`). | | `versionCode` | string\|null | Internal version code. | | `iconUrl` | string\|null | App icon image URL. | | `storeUrl` | string\|null | Public AppGallery detail page URL. | | `region` | string | Region catalog the record came from. | | `locale` | string | Locale used for the request. | | `searchKeyword` | string\|null | Keyword that surfaced this app (`null` for direct lookups). | | `sha256` | string\|null | APK file hash where published. | | `contentHash` | string | Stable 16-char fingerprint of the record. | | `source` | string | Always `huawei-appgallery`. | | `scrapedAt` | string | ISO timestamp of capture. | #### With `fetchDetails: true` | Field | Type | Description | |---|---|---| | `fullDescription` | string\|null | Full app description (raw). | | `descriptionText` | string\|null | Full description as plain text. | | `editorReview` | string\|null | AppGallery editor's review where published. | | `releaseDate` | string\|null | Release or last-update date as published. | | `ratingCount` | number\|null | Number of ratings. | | `scoredBy` | string\|null | Rating count as published on the detail page. | | `commentCount` | number\|null | Number of user comments. | | `downloadCount` | number\|null | Numeric download count (paired with `downloadCountLabel`). | | `contentRating` | string\|null | Content/age rating label (e.g. `Rated 18+`). | | `minAge` | string\|null | Minimum age where published. | | `privacyPolicyUrl` | string\|null | Developer privacy policy URL. | | `website` | string\|null | Developer website where published. | | `permissions` | array\|null | Requested permissions, each `{ group, title, description }`. | | `permissionCount` | number\|null | Total number of sensitive permissions requested. | | `screenshots` | array\|null | Screenshot image URLs. | | `md5` | string\|null | APK MD5 hash where published. | | `detailEnriched` | boolean | Whether detail enrichment succeeded for this record. | #### Example record ```json { "appId": "C100495631", "packageName": "com.whatsapp", "name": "WhatsApp Messenger", "developer": "WhatsApp LLC", "category": "Communication", "briefDescription": "Simple. Reliable. Private.", "rating": 4.4, "downloadCountLabel": "500M+", "price": null, "isFree": true, "size": "42.3 MB", "sizeBytes": 44346982, "versionName": "2.24.5.78", "versionCode": "242578", "iconUrl": "https://appimg.dbankcdn.com/.../icon.png", "storeUrl": "https://appgallery.huawei.com/app/C100495631", "region": "europe", "locale": "en_US", "searchKeyword": "whatsapp", "sha256": "9f2c...e1a7", "fullDescription": "WhatsApp from Meta is a free messaging and video calling app...", "descriptionText": "WhatsApp from Meta is a free messaging and video calling app...", "releaseDate": "2026-06-30", "newFeatures": "Bug fixes and performance improvements.", "ratingCount": 46, "scoredBy": "46", "commentCount": 15, "downloadCount": 2067, "contentRating": "Rated 18+", "minAge": "18", "privacyPolicyUrl": "https://telegram.org/privacy", "website": "https://telegram.org/privacy", "editorReview": "Pure instant messaging โ€” simple, fast, secure.", "permissions": [ { "group": "Contacts", "title": "Read your contacts", "description": "Allows the app to read, save, and share data related to your phone and email contacts." }, { "group": "Camera", "title": "Camera", "description": "Allows the app to take photos and videos." } ], "permissionCount": 24, "screenshots": ["https://appimg-dre.dbankcdn.com/.../screenshut1.jpg", "https://appimg-dre.dbankcdn.com/.../screenshut2.jpg"], "md5": "B24183E850A441FB61B6BBBDD40CE6AD", "contentHash": "a1b2c3d4e5f60718", "source": "huawei-appgallery", "scrapedAt": "2026-07-18T09:15:00.000Z" } ```` *** ### Examples **Search for messaging apps in the Europe catalog:** ```json { "searchQueries": ["whatsapp", "telegram", "signal"], "region": "europe", "locale": "en_US", "maxItemsPerQuery": 50, "fetchDetails": true } ``` **Fast search without detail enrichment:** ```json { "searchQueries": ["photo editor"], "region": "europe", "maxItemsPerQuery": 200, "fetchDetails": false } ``` **Look up specific apps by App ID:** ```json { "appIds": ["C100495631", "C101184875"], "region": "europe", "locale": "en_US", "fetchDetails": true } ``` **Localised catalog in German:** ```json { "searchQueries": ["vpn"], "region": "europe", "locale": "de_DE", "maxItemsPerQuery": 100, "fetchDetails": true } ``` *** ### ๐Ÿ’ฐ Pricing Pay-per-result โ€” you only pay for successfully retrieved apps. Failed retries are never charged. The price depends on how much data you collect per app: | Result type | Price per 1,000 | When | |---|---|---| | **Full detail** | **$4.99** | `fetchDetails: true` โ€” full description, screenshots, permissions, ratings and more | | **List** | **$1.49** | `fetchDetails: false` โ€” search-listing fields only | | Apps | Detail | List | |---|---|---| | 100 | ~$0.50 | ~$0.15 | | 1,000 | ~$4.99 | ~$1.49 | | 10,000 | ~$49.90 | ~$14.90 | > Flat-rate alternatives typically charge $29โ€“$49/month regardless of usage. Subscription tiers lower the detail rate further, down to $4.02 per 1,000 at the highest tier. Use the **Max apps per keyword** cap to control your spend exactly. *** ### Performance | Run size | Typical time | |---|---| | 50 apps (details on) | 1โ€“2 minutes | | 200 apps (details on) | 4โ€“7 minutes | | 200 apps (details off) | under 2 minutes | Detail enrichment fetches one extra request per app. Turn it off for the fastest catalog sweeps. *** ### Known limitations - **Keyword matching is literal.** AppGallery search does not correct typos or expand synonyms โ€” "wasap" will not find WhatsApp. Use the app's real name. - **Some fields depend on the developer.** Screenshots, permissions, developer email and content rating are only returned when the developer published them. - **Catalogs differ by region.** An app present in Europe may be absent in Singapore or China, and vice versa. - **Comment/rating counts** are surfaced where the store exposes them and may be `null` for some apps. *** ### Technical details - **Source:** Huawei AppGallery โ€” Europe, Singapore, Russia and China catalogs - **Coverage:** keyword search and direct App ID lookup, localisable per region - **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 ## `searchQueries` (type: `array`): List of keywords to search the AppGallery catalog for (e.g. "whatsapp", "photo editor"). AppGallery matches keywords closely, so use the app's real name where possible. Leave empty if you are looking up apps by App ID instead. ## `appIds` (type: `array`): List of specific Huawei AppGallery App IDs to fetch directly (e.g. "C100495631"). Use this to enrich known apps without searching. Combine with or use instead of Search keywords. ## `region` (type: `string`): AppGallery regional catalog to query. Different regions expose different app catalogs and localised metadata. ## `locale` (type: `string`): Locale code for app names, categories and descriptions (e.g. "en\_US", "de\_DE", "fr\_FR"). Must be a locale supported by the chosen region. ## `maxItemsPerQuery` (type: `integer`): Maximum number of apps to collect for each search keyword. Set to 0 for unlimited (until the catalog runs out of results). Ignored for direct App ID lookups. ## `fetchDetails` (type: `boolean`): When enabled, each app is enriched with detail-page fields: full description, release date, screenshots, permissions, content rating, privacy policy URL and more. Disable for a faster, lighter run that returns search-listing fields only. ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies are required โ€” AppGallery serves an empty catalog to datacenter IPs. The region's country is selected automatically when left at the default. ## Actor input object example ```json { "searchQueries": [ "whatsapp", "vpn", "photo editor" ], "appIds": [ "C100495631" ], "region": "europe", "locale": "en_US", "maxItemsPerQuery": 100, "fetchDetails": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "searchQueries": [ "whatsapp" ], "region": "europe", "locale": "en_US", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("unfenced-group/huawei-appgallery-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 = { "searchQueries": ["whatsapp"], "region": "europe", "locale": "en_US", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("unfenced-group/huawei-appgallery-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 '{ "searchQueries": [ "whatsapp" ], "region": "europe", "locale": "en_US", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call unfenced-group/huawei-appgallery-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/huawei-appgallery-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Huawei AppGallery Scraper", "description": "Extract app listings and full metadata from Huawei AppGallery: descriptions, ratings, downloads, screenshots, permissions, version, size, developer and category. Search or App ID lookup across EU, Singapore, Russia and China. No API key.", "version": "0.0", "x-build-id": "cjNpzSCtTsSn2B4Q2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~huawei-appgallery-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-huawei-appgallery-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~huawei-appgallery-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-huawei-appgallery-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~huawei-appgallery-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-huawei-appgallery-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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "List of keywords to search the AppGallery catalog for (e.g. \"whatsapp\", \"photo editor\"). AppGallery matches keywords closely, so use the app's real name where possible. Leave empty if you are looking up apps by App ID instead.", "default": [], "items": { "type": "string" } }, "appIds": { "title": "App IDs", "type": "array", "description": "List of specific Huawei AppGallery App IDs to fetch directly (e.g. \"C100495631\"). Use this to enrich known apps without searching. Combine with or use instead of Search keywords.", "default": [], "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "europe", "singapore", "russia", "china" ], "type": "string", "description": "AppGallery regional catalog to query. Different regions expose different app catalogs and localised metadata.", "default": "europe" }, "locale": { "title": "Locale", "type": "string", "description": "Locale code for app names, categories and descriptions (e.g. \"en_US\", \"de_DE\", \"fr_FR\"). Must be a locale supported by the chosen region.", "default": "en_US" }, "maxItemsPerQuery": { "title": "Max apps per keyword", "minimum": 0, "type": "integer", "description": "Maximum number of apps to collect for each search keyword. Set to 0 for unlimited (until the catalog runs out of results). Ignored for direct App ID lookups.", "default": 100 }, "fetchDetails": { "title": "Fetch full app details", "type": "boolean", "description": "When enabled, each app is enriched with detail-page fields: full description, release date, screenshots, permissions, content rating, privacy policy URL and more. Disable for a faster, lighter run that returns search-listing fields only.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Residential proxies are required โ€” AppGallery serves an empty catalog to datacenter IPs. The region's country is selected automatically when left at the default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```