# Tencent Huxuan Creator Marketplace Scraper — WeChat KOL Data (`sian.agency/tencent-huxuan-kol-analytics`) Actor Extract Tencent Huxuan creator marketplace data: search WeChat Video Account (视频号) and Official Account (公众号) KOLs, then enrich with pricing tiers, audience & viewer demographics, cooperation indices, and recent content performance for influencer marketing and creator due diligence. - **URL**: https://apify.com/sian.agency/tencent-huxuan-kol-analytics.md - **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community) - **Categories:** Social media, Marketing, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 video account creator search results 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.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 ## Tencent Huxuan Creator Marketplace Scraper — WeChat KOL Data & API 🚀 [![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![WeChat Channels Scraper](https://img.shields.io/badge/Store-WeChat%20Channels%20Scraper-07C160)](https://apify.com/sian.agency/wechat-channels-scraper?fpr=sian) [![WeChat Official Account Scraper](https://img.shields.io/badge/Store-WeChat%20Official%20Account%20Scraper-07C160)](https://apify.com/sian.agency/wechat-official-account-data-scraper?fpr=sian) [![Douyin Xingtu KOL Analytics](https://img.shields.io/badge/Store-Douyin%20Xingtu%20KOL%20Analytics-161823)](https://apify.com/sian.agency/douyin-xingtu-kol-analytics?fpr=sian) #### 🆕 The only Apify actor covering Tencent's Huxuan creator marketplace ##### Search, vet, and price WeChat KOLs — for influencer agencies and brand teams entering the WeChat ecosystem --- ### 📋 Overview **Get inside Tencent's own creator marketplace** — search and enrich WeChat Video Account (视频号) and Official Account (公众号) creators with the same pricing, audience, and performance data Tencent shows advertisers. **Why brands and agencies choose us:** - ✅ **First-mover coverage**: zero other Apify actors index Tencent's Huxuan marketplace - 🔀 **Dual-surface search**: WeChat Video Account and Official Account creators in one actor - 👁️ **Two-sided audience data**: a creator's own follower base AND the actual viewer/reader demographics of their recent content — most tools expose only one side - 💰 **Built-in rate-card intelligence**: short-video, long-video, advertorial, and collection price tiers plus propagation/cooperation/cost-effectiveness indices - 🕵️ **Sponsor attribution**: recent videos and articles carry advertiser name + industry, so you see exactly which brands a creator is currently working with - ✨ **NEW**: launch release — six operations covering discovery, profile enrichment, and content history for both account types ### ✨ Features - 🔍 **Video Account Creator Search** — search or browse the 视频号 marketplace by keyword - 🔍 **Official Account Creator Search** — search or browse the 公众号 marketplace by keyword - 👤 **Video Account Creator Details** — full profile, price tiers, cooperation indices, follower + viewer demographics - 👤 **Official Account Creator Details** — full profile, price config, follower + reader demographics, recent-article averages - 🎬 **Video Account Recent Videos** — recent video performance with sponsor attribution - 📰 **Official Account Article List** — recent article performance with sponsor attribution - 💲 **Rate-card fields** — short/long-video price, advertorial/specified/collection/image price tiers - 📊 **Marketplace indices** — propagation, social interaction, cooperation, and cost-effectiveness scores - 🌍 **Bilingual data** — creator bios, locations, and marketplace categories in native Chinese, structured into clean English field names ### 🎬 Quick Start Pick one operation, provide the required input, and run. Search operations need only a keyword (or nothing, to browse); enrichment operations need the creator's `appId` from a prior search. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~tencent-huxuan-kol-analytics/runs?token=YOUR_TOKEN \ -d '{"operation": "videoCreatorSearch", "keyword": "美妆"}' ```` ### 🚀 Getting Started (3 Simple Steps) #### Step 1: Search Run `Video Account Creator Search` or `Official Account Creator Search` with a keyword (or leave it empty to browse the default marketplace list). #### Step 2: Grab an appId Copy the `creatorId` (the upstream `appId`) from any search result row. #### Step 3: Enrich Run `Video/Official Account Creator Details`, `Video Account Recent Videos`, or `Official Account Article List` with that `appId`. **That's it! In minutes, you'll have:** - A shortlist of qualified WeChat KOLs - Full pricing and audience-demographic profiles - Recent content performance with sponsor attribution ### 📥 Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | operation | string | Yes | One of `videoCreatorSearch`, `oaCreatorSearch`, `videoCreatorDetail`, `oaCreatorDetail`, `videoRecentVideos`, `oaArticleList` | | keyword | string | No | Search term for Search operations (empty = browse marketplace) or Article List filter | | appId | string | Conditional | Creator app ID, required for Details, Recent Videos, and Article List | | videoType | string | No | Recent Videos filter: `ALL`, `ORDER`, `HOT`, `PERSON` | | articleType | string | No | Article List filter: `ALL`, `ORDER` | | beginDate / startDate | string | Conditional | Date range start (`yyyyMMdd`), required for Recent Videos / Article List | | endDate | string | Conditional | Date range end (`yyyyMMdd`), required for Recent Videos / Article List | | page | integer | No | Start page for paginated operations | | maxPages | integer | No | How many pages to fetch (default 3, max 50) | **Example:** ```json { "operation": "videoCreatorDetail", "appId": "sphiecuDcvQu4bf" } ``` **Search example:** ```json { "operation": "oaCreatorSearch", "keyword": "财经", "maxPages": 2 } ``` ### 📤 Output Results are saved to the Apify dataset with **60+ fields** including: | Field | Type | Description | |-------|------|--------------| | creatorId | string | The creator's app ID | | nickname | string | Display name | | accountType | string | `video` or `official` | | fansNumLevel | string | Follower-count bucket | | shortVideoPrice / longVideoPrice | string | Rate-card pricing | | cooperationIndex / costEffectivenessIndex | number | Marketplace scoring indices | | ownAudienceAge / ownAudienceGender / ownAudienceArea | array | Follower-base demographics | | engagedAudienceAge / engagedAudienceGender | array | Actual content-viewer demographics | | contentHeadline / contentUrl / readCount | string | Recent video/article performance | | aderName / industryName | string | Sponsor attribution | **Example:** ```json { "operation": "videoCreatorSearch", "accountType": "video", "creatorId": "sphiecuDcvQu4bf", "nickname": "硬核资本论", "cityLabel": "广州市", "fansNumLevel": "500万+", "shortVideoPrice": "28000000", "cooperationIndex": 7412, "costEffectivenessIndex": 6794, "status": "success" } ``` ### 💼 Use Cases & Examples #### 1. WeChat KOL Discovery & Due Diligence **Influencer agencies vetting WeChat creators before pitching them to brand clients.** **Input:** A niche keyword (`美妆`, `财经`, `母婴`) **Output:** A ranked list of matching creators with pricing and marketplace scores **Use:** Build qualified shortlists in minutes instead of manually browsing the marketplace #### 2. Two-Sided Audience Demographics for Campaign Fit **CPG and beauty brands confirming a creator's actual audience matches their target segment.** **Input:** A creator `appId` **Output:** Follower-base demographics AND actual viewer/reader demographics for recent content **Use:** Catch creators whose engaged audience skews differently from their raw follower count #### 3. Creator Rate-Card & Cooperation Intelligence **Media buyers benchmarking sponsorship pricing before negotiating.** **Input:** A creator `appId` **Output:** Short/long-video price, advertorial tiers, cooperation and cost-effectiveness indices **Use:** Walk into negotiations with Tencent's own marketplace pricing data in hand #### 4. Sponsor & Competitive-Intelligence Tracking **Brand teams monitoring which competitors are sponsoring which WeChat creators.** **Input:** A creator `appId` and a date range **Output:** Recent videos/articles tagged with sponsor name and industry **Use:** Track competitor sponsorship activity across the WeChat creator economy #### 5. China Influencer Database Building **Market-research firms and KOL-matching platforms building a proprietary WeChat creator database.** **Input:** A list of niche keywords **Output:** A structured, continuously refreshable dataset of WeChat KOLs **Use:** Power an in-house or client-facing influencer-discovery tool ### 🔗 Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/tencent-huxuan-kol-analytics').call({ operation: 'videoCreatorSearch', keyword: '美妆' }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/tencent-huxuan-kol-analytics').call( run_input={'operation': 'oaCreatorDetail', 'appId': 'wxedea645114469b28'} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~tencent-huxuan-kol-analytics/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"operation": "videoCreatorSearch", "keyword": "美妆"}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule or webhook 2. **HTTP Request**: Call the actor API with your chosen operation 3. **Process**: Handle the returned JSON dataset rows 4. **Action**: Save to your CRM, notify your team, or feed a downstream model ### 📊 Performance & Pricing #### FREE Tier (Try It Now) - Run any operation with a small `maxPages` — full feature access, same data quality - No credit card required - Perfect for testing a keyword or vetting a single creator #### PAID Tier (Production Ready) - Scale up `maxPages` for full marketplace coverage - Pay-per-result: only charged for successfully returned rows - Bulk search pricing tiers taper as your usage grows 💰 **Transparent, per-row pricing** — no flat subscription, no wasted spend on failed calls. 🔗 [View current pricing](https://apify.com/sian.agency/tencent-huxuan-kol-analytics?fpr=sian) ### ❓ Frequently Asked Questions **Q: What's the difference between Video Account and Official Account creators?** A: Video Account (视频号) creators publish short-form video content; Official Account (公众号) creators publish articles. Tencent's Huxuan marketplace covers both — this actor searches and enriches each independently. **Q: How many creators can I get per search?** A: Each search page returns up to ~30 creators. Use `maxPages` to fetch more. **Q: Do I need an appId before I can run a Details/Recent-Videos/Article-List operation?** A: Yes — run a Search operation first, then copy the `creatorId` from a result row. **Q: What output formats are available?** A: JSON, CSV, Excel — export directly from the Apify dataset. **Q: What do the pricing fields mean?** A: `shortVideoPrice`/`longVideoPrice` and the tiered price arrays are Tencent Huxuan's own rate-card figures for that creator, in the upstream's native unit — cross-check against the creator's own listing before quoting a client. **Q: Is this legal?** A: Yes — we only extract publicly available marketplace listings. See our [legal section](#-is-it-legal-to-scrape-data). **Q: How long does a run take?** A: A single search page or a Details call typically completes in a few seconds; larger multi-page runs scale linearly with `maxPages`. ### 🐛 Troubleshooting **No rows returned from a Details / Recent Videos / Article List operation** - Confirm the `appId` was copied from a real search result, not typed by hand - Video Account IDs start with `sph...`; Official Account IDs start with `wx...` — using the wrong prefix for the wrong operation returns nothing **Recent Videos / Article List returns an empty page** - Widen the `beginDate`/`endDate` (or `startDate`/`endDate`) range — the creator may not have published in a narrow window **Search returns fewer results than expected** - Try a broader or different keyword, or leave `keyword` empty to browse the full marketplace list ### ⚖️ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### ⚠️ Trademark Disclaimer This is an **independent scraping tool**. It is not affiliated with, endorsed by, or sponsored by Tencent Holdings Limited, WeChat, or the Huxuan (互选) creator-marketplace platform. The Tencent®, WeChat®/微信®, and Huxuan®/互选® names appear under nominative fair use, solely to describe the platform this tool extracts publicly available marketplace data from. ### 🤝 Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's repository - Check [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - 📧 *** **Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `operation` (type: `string`): 🎯 **PICK ONE OPERATION PER RUN.** Each run produces one clean dataset matching the chosen mode. **Discovery** - **🔍 Video Account Creator Search** — search WeChat Video Account (视频号) KOLs by keyword, or leave empty to browse the default marketplace list - **🔍 Official Account Creator Search** — search WeChat Official Account (公众号) KOLs by keyword, or leave empty to browse the default marketplace list **Creator profile & pricing** - **👤 Video Account Creator Details** — full profile: pricing tiers, cooperation indices, follower + viewer audience demographics - **👤 Official Account Creator Details** — full profile: pricing tiers, follower + reader audience demographics, recent article performance **Content history** - **🎬 Video Account Recent Videos** — a Video Account creator's recent videos with engagement + sponsor attribution - **📰 Official Account Article List** — an Official Account creator's recent articles with engagement + sponsor attribution 💡 **TIP:** Start with a Search operation to find `appId`s, then drill into individual creators with the Details / Recent Videos / Article List operations. ## `keyword` (type: `string`): 🔍 **Used by Video/Official Account Creator Search (optional — leave empty to browse the default marketplace list) and Official Account Article List (optional — filters articles by title keyword).** Chinese or English: - `美妆` (beauty) - `财经` (finance) - `母婴` (mom & baby) ⚠️ **Ignored** for Details and Recent Videos operations. ## `appId` (type: `string`): 👤 **Required for Video/Official Account Creator Details, Video Account Recent Videos, and Official Account Article List.** The Huxuan creator app ID. Find it in the `appId` field of any Creator Search result row: - Video Account creators start with `sph...` - Official Account creators start with `wx...` 💡 **TIP:** Run a Search operation first to surface qualified `appId`s, then drill into individual creators. ## `videoType` (type: `string`): 🎬 **Video Account Recent Videos only.** Filter which videos to return. ## `articleType` (type: `string`): 📰 **Official Account Article List only.** Filter which articles to return. ## `beginDate` (type: `string`): 📅 **Required for Video Account Recent Videos.** Start of the date range, format `yyyyMMdd` (e.g. `20260601`). ## `startDate` (type: `string`): 📅 **Required for Official Account Article List.** Start of the date range, format `yyyyMMdd` (e.g. `20260601`). ## `endDate` (type: `string`): 📅 **Required for Video Account Recent Videos and Official Account Article List.** End of the date range, format `yyyyMMdd` (e.g. `20260701`). ## `page` (type: `integer`): 📄 **Applies to all paginated operations** (both Search ops, Recent Videos, Article List). The upstream page to start fetching from. Ignored for Details operations. ## `maxPages` (type: `integer`): 📄 **Applies to paginated operations** (both Search ops, Recent Videos, Article List). Ignored for Details operations. - \~30 creators per page (Search) - \~8-9 videos/articles per page (Recent Videos / Article List) 💡 **TIP:** Start small (1–3 pages) to preview results before scaling up. ⚠️ Hard cap: 50 pages to prevent runaway runs. FREE tier is always capped at 500 rows per run regardless of this setting. ## Actor input object example ```json { "operation": "videoCreatorSearch", "keyword": "美妆", "appId": "sphiecuDcvQu4bf", "videoType": "ALL", "articleType": "ALL", "beginDate": "20260601", "startDate": "20260601", "endDate": "20260701", "page": 1, "maxPages": 3 } ``` # Actor output Schema ## `results` (type: `string`): Tencent Huxuan creator-marketplace rows — one flat row per creator, video, or article, depending on the chosen operation. ## `htmlReport` (type: `string`): HTML report with run status, success/error row counts, success rate, pages fetched, duration, and the inputs used — written even on fatal crash. # 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 = { "appId": "sphiecuDcvQu4bf", "beginDate": "20260601", "startDate": "20260601", "endDate": "20260701" }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/tencent-huxuan-kol-analytics").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 = { "appId": "sphiecuDcvQu4bf", "beginDate": "20260601", "startDate": "20260601", "endDate": "20260701", } # Run the Actor and wait for it to finish run = client.actor("sian.agency/tencent-huxuan-kol-analytics").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 '{ "appId": "sphiecuDcvQu4bf", "beginDate": "20260601", "startDate": "20260601", "endDate": "20260701" }' | apify call sian.agency/tencent-huxuan-kol-analytics --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/tencent-huxuan-kol-analytics", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Tencent Huxuan Creator Marketplace Scraper — WeChat KOL Data", "description": "Extract Tencent Huxuan creator marketplace data: search WeChat Video Account (视频号) and Official Account (公众号) KOLs, then enrich with pricing tiers, audience & viewer demographics, cooperation indices, and recent content performance for influencer marketing and creator due diligence.", "version": "1.0", "x-build-id": "HtGCDWX421Kem9cTc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~tencent-huxuan-kol-analytics/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-tencent-huxuan-kol-analytics", "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/sian.agency~tencent-huxuan-kol-analytics/runs": { "post": { "operationId": "runs-sync-sian.agency-tencent-huxuan-kol-analytics", "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/sian.agency~tencent-huxuan-kol-analytics/run-sync": { "post": { "operationId": "run-sync-sian.agency-tencent-huxuan-kol-analytics", "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": [ "operation" ], "properties": { "operation": { "title": "🎯 Operation — what do you want to extract?", "enum": [ "videoCreatorSearch", "oaCreatorSearch", "videoCreatorDetail", "oaCreatorDetail", "videoRecentVideos", "oaArticleList" ], "type": "string", "description": "🎯 **PICK ONE OPERATION PER RUN.** Each run produces one clean dataset matching the chosen mode.\n\n**Discovery**\n- **🔍 Video Account Creator Search** — search WeChat Video Account (视频号) KOLs by keyword, or leave empty to browse the default marketplace list\n- **🔍 Official Account Creator Search** — search WeChat Official Account (公众号) KOLs by keyword, or leave empty to browse the default marketplace list\n\n**Creator profile & pricing**\n- **👤 Video Account Creator Details** — full profile: pricing tiers, cooperation indices, follower + viewer audience demographics\n- **👤 Official Account Creator Details** — full profile: pricing tiers, follower + reader audience demographics, recent article performance\n\n**Content history**\n- **🎬 Video Account Recent Videos** — a Video Account creator's recent videos with engagement + sponsor attribution\n- **📰 Official Account Article List** — an Official Account creator's recent articles with engagement + sponsor attribution\n\n💡 **TIP:** Start with a Search operation to find `appId`s, then drill into individual creators with the Details / Recent Videos / Article List operations.", "default": "videoCreatorSearch" }, "keyword": { "title": "🔍 Search Keyword", "type": "string", "description": "🔍 **Used by Video/Official Account Creator Search (optional — leave empty to browse the default marketplace list) and Official Account Article List (optional — filters articles by title keyword).** Chinese or English:\n- `美妆` (beauty)\n- `财经` (finance)\n- `母婴` (mom & baby)\n\n⚠️ **Ignored** for Details and Recent Videos operations." }, "appId": { "title": "👤 Creator App ID (appId)", "type": "string", "description": "👤 **Required for Video/Official Account Creator Details, Video Account Recent Videos, and Official Account Article List.**\n\nThe Huxuan creator app ID. Find it in the `appId` field of any Creator Search result row:\n- Video Account creators start with `sph...`\n- Official Account creators start with `wx...`\n\n💡 **TIP:** Run a Search operation first to surface qualified `appId`s, then drill into individual creators.", "default": "sphiecuDcvQu4bf" }, "videoType": { "title": "🎬 Video Type Filter (Recent Videos)", "enum": [ "ALL", "ORDER", "HOT", "PERSON" ], "type": "string", "description": "🎬 **Video Account Recent Videos only.** Filter which videos to return.", "default": "ALL" }, "articleType": { "title": "📰 Article Type Filter (Article List)", "enum": [ "ALL", "ORDER" ], "type": "string", "description": "📰 **Official Account Article List only.** Filter which articles to return.", "default": "ALL" }, "beginDate": { "title": "📅 Start Date (Recent Videos)", "type": "string", "description": "📅 **Required for Video Account Recent Videos.** Start of the date range, format `yyyyMMdd` (e.g. `20260601`).", "default": "20260601" }, "startDate": { "title": "📅 Start Date (Article List)", "type": "string", "description": "📅 **Required for Official Account Article List.** Start of the date range, format `yyyyMMdd` (e.g. `20260601`).", "default": "20260601" }, "endDate": { "title": "📅 End Date (Recent Videos / Article List)", "type": "string", "description": "📅 **Required for Video Account Recent Videos and Official Account Article List.** End of the date range, format `yyyyMMdd` (e.g. `20260701`).", "default": "20260701" }, "page": { "title": "📄 Start Page", "minimum": 1, "type": "integer", "description": "📄 **Applies to all paginated operations** (both Search ops, Recent Videos, Article List). The upstream page to start fetching from. Ignored for Details operations.", "default": 1 }, "maxPages": { "title": "📄 Max pages to fetch", "minimum": 1, "maximum": 50, "type": "integer", "description": "📄 **Applies to paginated operations** (both Search ops, Recent Videos, Article List). Ignored for Details operations.\n\n- ~30 creators per page (Search)\n- ~8-9 videos/articles per page (Recent Videos / Article List)\n\n💡 **TIP:** Start small (1–3 pages) to preview results before scaling up.\n\n⚠️ Hard cap: 50 pages to prevent runaway runs. FREE tier is always capped at 500 rows per run regardless of this setting.", "default": 3 } } }, "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 } } } } } } } } } } ```