{ "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 } } } } } } } } } }