# China KOL Database — WeChat Creator Search

**Use case:** 

Search Tencent's Huxuan marketplace for WeChat Video Account creators by keyword — handles, fan counts, follower demographics. Export CSV/JSON, no code.

## Input

```json
{
  "operation": "videoCreatorSearch",
  "keyword": "美妆",
  "appId": "sphiecuDcvQu4bf",
  "videoType": "ALL",
  "articleType": "ALL",
  "beginDate": "20260601",
  "startDate": "20260601",
  "endDate": "20260701",
  "page": 1,
  "maxPages": 3
}
```

## Output

```json
{
  "operation": {
    "label": "🎯 Operation",
    "format": "string"
  },
  "accountType": {
    "label": "🏷️ Account Type",
    "format": "string"
  },
  "creatorId": {
    "label": "🆔 Creator App ID",
    "format": "string"
  },
  "nickname": {
    "label": "📛 Nickname",
    "format": "string"
  },
  "avatarUrl": {
    "label": "🖼️ Avatar URL",
    "format": "string"
  },
  "qrCodeUrl": {
    "label": "📱 QR / Follow Link",
    "format": "string"
  },
  "bioSynopsis": {
    "label": "📝 Bio",
    "format": "string"
  },
  "cityLabel": {
    "label": "🏙️ City",
    "format": "string"
  },
  "provinceLabel": {
    "label": "🗺️ Province",
    "format": "string"
  },
  "authProfession": {
    "label": "💼 Auth Profession",
    "format": "string"
  },
  "authCompany": {
    "label": "🏢 Auth Company",
    "format": "string"
  },
  "categoryLevel1": {
    "label": "📂 Category (L1)",
    "format": "integer"
  },
  "categoryLevel2": {
    "label": "📁 Category (L2)",
    "format": "integer"
  },
  "fansNumLevel": {
    "label": "👥 Followers (bucket)",
    "format": "string"
  },
  "fansNum": {
    "label": "👥 Followers (exact)",
    "format": "integer"
  },
  "mcnName": {
    "label": "🏢 MCN Name",
    "format": "string"
  },
  "score": {
    "label": "⭐ Score",
    "format": "number"
  },
  "shortVideoPrice": {
    "label": "💰 Short-Video Price",
    "format": "string"
  },
  "longVideoPrice": {
    "label": "💰 Long-Video Price",
    "format": "string"
  },
  "advertorialPriceTiers": {
    "label": "💵 Advertorial Price Tiers",
    "format": "array"
  },
  "specifiedPriceTiers": {
    "label": "💵 Specified Price Tiers",
    "format": "array"
  },
  "collectionPriceTiers": {
    "label": "💵 Collection Price Tiers",
    "format": "array"
  },
  "imagePriceTiers": {
    "label": "💵 Image Price Tiers",
    "format": "array"
  },
  "readPriceTiers": {
    "label": "💵 Read Price Tiers",
    "format": "array"
  },
  "propagationIndex": {
    "label": "📈 Propagation Index",
    "format": "integer"
  },
  "socialInteractionIndex": {
    "label": "💬 Social Interaction Index",
    "format": "integer"
  },
  "cooperationIndex": {
    "label": "🤝 Cooperation Index",
    "format": "integer"
  },
  "costEffectivenessIndex": {
    "label": "💸 Cost-Effectiveness Index",
    "format": "integer"
  },
  "indexComposite": {
    "label": "📊 Composite Index",
    "format": "string"
  },
  "indexContent": {
    "label": "📊 Content Index",
    "format": "string"
  },
  "indexCooperation": {
    "label": "📊 Cooperation Sub-Index",
    "format": "string"
  },
  "indexCost": {
    "label": "📊 Cost Sub-Index",
    "format": "string"
  },
  "indexGrowth": {
    "label": "📊 Growth Index",
    "format": "string"
  },
  "indexSocial": {
    "label": "📊 Social Sub-Index",
    "format": "string"
  },
  "avgReadCount": {
    "label": "👁️ Avg Read Count",
    "format": "string"
  },
  "medianReadCount": {
    "label": "👁️ Median Read Count",
    "format": "string"
  },
  "avgLikeCount": {
    "label": "❤️ Avg Like Count",
    "format": "string"
  },
  "avgInteractionCount": {
    "label": "💬 Avg Interaction Count",
    "format": "string"
  },
  "expectedCpm": {
    "label": "💲 Expected CPM",
    "format": "number"
  },
  "expectedCpe": {
    "label": "💲 Expected CPE",
    "format": "string"
  },
  "interactionRate": {
    "label": "📈 Interaction Rate",
    "format": "integer"
  },
  "playFinishRate": {
    "label": "▶️ Play-Finish Rate",
    "format": "integer"
  },
  "fansNumGrowthRate": {
    "label": "📈 Follower Growth Rate",
    "format": "integer"
  },
  "orderCnt": {
    "label": "🧾 Past Order Count",
    "format": "integer"
  },
  "orderAvgReadCount": {
    "label": "🧾 Order Avg Read Count",
    "format": "string"
  },
  "tagIds": {
    "label": "🏷️ Tag IDs",
    "format": "array"
  },
  "ownAudienceAge": {
    "label": "👥 Follower Age Distribution",
    "format": "array"
  },
  "ownAudienceGender": {
    "label": "👥 Follower Gender Distribution",
    "format": "array"
  },
  "ownAudienceDevice": {
    "label": "📱 Follower Device Distribution",
    "format": "array"
  },
  "ownAudienceArea": {
    "label": "🌍 Follower City Distribution",
    "format": "array"
  },
  "ownAudienceProvince": {
    "label": "🌍 Follower Province Distribution",
    "format": "array"
  },
  "ownAudienceInterest": {
    "label": "🎯 Follower Interest Distribution",
    "format": "array"
  },
  "engagedAudienceAge": {
    "label": "👁️ Viewer/Reader Age Distribution",
    "format": "array"
  },
  "engagedAudienceGender": {
    "label": "👁️ Viewer/Reader Gender Distribution",
    "format": "array"
  },
  "engagedAudienceDevice": {
    "label": "📱 Viewer/Reader Device Distribution",
    "format": "array"
  },
  "engagedAudienceArea": {
    "label": "🌍 Viewer/Reader City Distribution",
    "format": "array"
  },
  "engagedAudienceProvince": {
    "label": "🌍 Viewer/Reader Province Distribution",
    "format": "array"
  },
  "contentId": {
    "label": "🎬 Content ID",
    "format": "string"
  },
  "contentHeadline": {
    "label": "📝 Content Headline",
    "format": "string"
  },
  "contentUrl": {
    "label": "🔗 Content URL",
    "format": "string"
  },
  "coverUrl": {
    "label": "🖼️ Cover Image URL",
    "format": "string"
  },
  "publishTime": {
    "label": "📅 Publish Time",
    "format": "string"
  },
  "readCount": {
    "label": "👁️ Read Count",
    "format": "string"
  },
  "commentCount": {
    "label": "💬 Comment Count",
    "format": "string"
  },
  "favCount": {
    "label": "⭐ Favorite Count",
    "format": "string"
  },
  "heartCount": {
    "label": "❤️ Like Count (Video)",
    "format": "string"
  },
  "shareCount": {
    "label": "🔁 Share Count",
    "format": "string"
  },
  "likeCount": {
    "label": "👍 Like Count (Article)",
    "format": "string"
  },
  "industryName": {
    "label": "🏭 Sponsor Industry",
    "format": "string"
  },
  "aderName": {
    "label": "🏢 Sponsor Name",
    "format": "string"
  },
  "resultTotal": {
    "label": "🔢 Total Available",
    "format": "integer"
  },
  "pageNumber": {
    "label": "📄 Page Number",
    "format": "integer"
  },
  "processedAt": {
    "label": "⏰ Processed At",
    "format": "string"
  },
  "scrapingDate": {
    "label": "📅 Scraping Date",
    "format": "string"
  },
  "status": {
    "label": "✅ Status",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [Tencent Huxuan Creator Marketplace Scraper — WeChat KOL Data](https://apify.com/sian.agency/tencent-huxuan-kol-analytics) with a specific input configuration. Visit the [Actor detail page](https://apify.com/sian.agency/tencent-huxuan-kol-analytics) to learn more, explore other use cases, and run it yourself.