Tencent Huxuan Creator Marketplace Scraper — WeChat KOL Data & API 🚀

🆕 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.

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:

{
  "operation": "videoCreatorDetail",
  "appId": "sphiecuDcvQu4bf"
}

Search example:

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

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

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

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

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

❓ 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.

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.

⚠️ 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

Join our active support community

• For issues or questions, open an issue in the actor's repository
• Check SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools