# Xiaohongshu Influencer Audience Analytics

**Use case:** 

Pull any Xiaohongshu creator's audience demographics — age, gender, geography, interests and device split — for campaign-fit checks. Export CSV/JSON.

## Input

```json
{
  "operation": "kolFansPortrait",
  "userId": "5c0fdbed00000000050043cc",
  "noteId": "67dee5750000000016024519",
  "keyword": "美妆",
  "searchType": "NICKNAME",
  "fansAge": "ALL",
  "fansGender": "ALL",
  "gender": "ALL",
  "business": "DAILY_NOTE",
  "dateType": "DAY_30",
  "increaseType": "FANS_TOTAL",
  "pageSize": 20,
  "maxPages": 3
}
```

## Output

```json
{
  "_fetchedAt": {
    "label": "⏰ Fetched At",
    "format": "string"
  },
  "_operation": {
    "label": "🎯 Operation",
    "format": "string"
  },
  "_page": {
    "label": "📄 Page",
    "format": "integer"
  },
  "_sourceKeyword": {
    "label": "🔍 Source Keyword",
    "format": "string"
  },
  "accumCommonImpMedinNum30d": {
    "label": "Accum Common Imp Medin Num30d",
    "format": "integer"
  },
  "accumCoopImpMedinNum30d": {
    "label": "Accum Coop Imp Medin Num30d",
    "format": "integer"
  },
  "accumPicCommonImpMedinNum30d": {
    "label": "Accum Pic Common Imp Medin Num30d",
    "format": "integer"
  },
  "accumVideoCommonImpMedinNum30d": {
    "label": "Accum Video Common Imp Medin Num30d",
    "format": "integer"
  },
  "activityList": {
    "label": "Activity List",
    "format": "array"
  },
  "avatarUrl": {
    "label": "Avatar Url",
    "format": "string"
  },
  "avgAgmv90d": {
    "label": "Avg Agmv90d",
    "format": "number"
  },
  "avgLiveViewerNum": {
    "label": "Avg Live Viewer Num",
    "format": "number"
  },
  "businessNoteCount": {
    "label": "Business Note Count",
    "format": "integer"
  },
  "buyerType": {
    "label": "Buyer Type",
    "format": "integer"
  },
  "classifyCode": {
    "label": "Classify Code",
    "format": "integer"
  },
  "clickMidNum": {
    "label": "Click Mid Num",
    "format": "integer"
  },
  "clickMidNumMcn": {
    "label": "Click Mid Num Mcn",
    "format": "integer"
  },
  "clothingIndustryPrice": {
    "label": "Clothing Industry Price",
    "format": "object"
  },
  "contentTags": {
    "label": "Content Tags",
    "format": "array"
  },
  "controlState": {
    "label": "Control State",
    "format": "integer"
  },
  "cooperateState": {
    "label": "Cooperate State",
    "format": "integer"
  },
  "cooperType": {
    "label": "Cooper Type",
    "format": "integer"
  },
  "coopNoteNum30d": {
    "label": "Coop Note Num30d",
    "format": "integer"
  },
  "currentLevel": {
    "label": "Current Level",
    "format": "integer"
  },
  "efficiencyValidUser": {
    "label": "Efficiency Valid User",
    "format": "integer"
  },
  "estimateCpuv30d": {
    "label": "Estimate Cpuv30d",
    "format": "number"
  },
  "estimatePictureCpm": {
    "label": "Estimate Picture Cpm",
    "format": "number"
  },
  "estimatePictureCpmCompare": {
    "label": "Estimate Picture Cpm Compare",
    "format": "number"
  },
  "estimatePictureEngageCost": {
    "label": "Estimate Picture Engage Cost",
    "format": "number"
  },
  "estimatePictureEngageCostCompare": {
    "label": "Estimate Picture Engage Cost Compare",
    "format": "number"
  },
  "estimateVideoCpm": {
    "label": "Estimate Video Cpm",
    "format": "number"
  },
  "estimateVideoCpmCompare": {
    "label": "Estimate Video Cpm Compare",
    "format": "number"
  },
  "estimateVideoEngageCost": {
    "label": "Estimate Video Engage Cost",
    "format": "number"
  },
  "estimateVideoEngageCostCompare": {
    "label": "Estimate Video Engage Cost Compare",
    "format": "number"
  },
  "fans30GrowthNum": {
    "label": "Fans30Growth Num",
    "format": "integer"
  },
  "fans30GrowthRate": {
    "label": "Fans30Growth Rate",
    "format": "number"
  },
  "fansActiveIn28dLv": {
    "label": "Fans Active In28d Lv",
    "format": "number"
  },
  "fansCount": {
    "label": "Fans Count",
    "format": "integer"
  },
  "fansEngageNum30dLv": {
    "label": "Fans Engage Num30d Lv",
    "format": "number"
  },
  "fansNum": {
    "label": "Fans Num",
    "format": "integer"
  },
  "fbState": {
    "label": "Fb State",
    "format": "integer"
  },
  "featureTags": {
    "label": "Feature Tags",
    "format": "array"
  },
  "forecastGroupCoverRateLower": {
    "label": "Forecast Group Cover Rate Lower",
    "format": "integer"
  },
  "forecastGroupCoverRateUpper": {
    "label": "Forecast Group Cover Rate Upper",
    "format": "integer"
  },
  "forecastReadUvLower": {
    "label": "Forecast Read Uv Lower",
    "format": "integer"
  },
  "forecastReadUvUpper": {
    "label": "Forecast Read Uv Upper",
    "format": "integer"
  },
  "gender": {
    "label": "Gender",
    "format": "string"
  },
  "hasBuyerAuth": {
    "label": "Has Buyer Auth",
    "format": "boolean"
  },
  "headPhoto": {
    "label": "Head Photo",
    "format": "string"
  },
  "homePageDisplay": {
    "label": "Home Page Display",
    "format": "integer"
  },
  "hundredLikePercent30": {
    "label": "Hundred Like Percent30",
    "format": "number"
  },
  "intentionInfo": {
    "label": "Intention Info",
    "format": "object"
  },
  "interMidCoop30": {
    "label": "Inter Mid Coop30",
    "format": "integer"
  },
  "interMidNum": {
    "label": "Inter Mid Num",
    "format": "integer"
  },
  "inviteReply48hNumRatio": {
    "label": "Invite Reply48h Num Ratio",
    "format": "number"
  },
  "isCollect": {
    "label": "Is Collect",
    "format": "boolean"
  },
  "isIndustryRecommend": {
    "label": "Is Industry Recommend",
    "format": "boolean"
  },
  "kliveCnt30d": {
    "label": "Klive Cnt30d",
    "format": "integer"
  },
  "kolHeadLabel": {
    "label": "Kol Head Label",
    "format": "integer"
  },
  "kolType": {
    "label": "Kol Type",
    "format": "integer"
  },
  "location": {
    "label": "Location",
    "format": "string"
  },
  "lowActive": {
    "label": "Low Active",
    "format": "boolean"
  },
  "lowerPrice": {
    "label": "Lower Price",
    "format": "integer"
  },
  "matchNoteNumber": {
    "label": "Match Note Number",
    "format": "integer"
  },
  "mcpuvNum30d": {
    "label": "Mcpuv Num30d",
    "format": "integer"
  },
  "mCpuvNum30d": {
    "label": "M Cpuv Num30d",
    "format": "integer"
  },
  "mengagementNum": {
    "label": "Mengagement Num",
    "format": "integer"
  },
  "mEngagementNum": {
    "label": "M Engagement Num",
    "format": "integer"
  },
  "mengagementNumMcn": {
    "label": "Mengagement Num Mcn",
    "format": "integer"
  },
  "mEngagementNumMcn": {
    "label": "M Engagement Num Mcn",
    "format": "integer"
  },
  "name": {
    "label": "Name",
    "format": "string"
  },
  "newHighQuality": {
    "label": "New High Quality",
    "format": "integer"
  },
  "nextLevel": {
    "label": "Next Level",
    "format": "integer"
  },
  "nickname": {
    "label": "Nickname",
    "format": "string"
  },
  "noteList": {
    "label": "Note List",
    "format": "array"
  },
  "personalTags": {
    "label": "Personal Tags",
    "format": "array"
  },
  "pictureClickMidNum": {
    "label": "Picture Click Mid Num",
    "format": "integer"
  },
  "pictureCpcBasePrice": {
    "label": "Picture Cpc Base Price",
    "format": "string"
  },
  "pictureCpcPerPrice": {
    "label": "Picture Cpc Per Price",
    "format": "string"
  },
  "pictureHundredLikePercent30": {
    "label": "Picture Hundred Like Percent30",
    "format": "integer"
  },
  "pictureInterMidNum": {
    "label": "Picture Inter Mid Num",
    "format": "integer"
  },
  "picturePrice": {
    "label": "Picture Price",
    "format": "integer"
  },
  "picturePriceGtZero": {
    "label": "Picture Price Gt Zero",
    "format": "boolean"
  },
  "pictureReadCost": {
    "label": "Picture Read Cost",
    "format": "string"
  },
  "pictureState": {
    "label": "Picture State",
    "format": "integer"
  },
  "pictureThousandLikePercent30": {
    "label": "Picture Thousand Like Percent30",
    "format": "integer"
  },
  "predictiveExposure": {
    "label": "Predictive Exposure",
    "format": "integer"
  },
  "priceState": {
    "label": "Price State",
    "format": "integer"
  },
  "promiseImpNum": {
    "label": "Promise Imp Num",
    "format": "string"
  },
  "readMidCoop30": {
    "label": "Read Mid Coop30",
    "format": "integer"
  },
  "redId": {
    "label": "Red Id",
    "format": "string"
  },
  "resemblance": {
    "label": "Resemblance",
    "format": "boolean"
  },
  "sellerRealIncomeAmt90d": {
    "label": "Seller Real Income Amt90d",
    "format": "number"
  },
  "showPrice": {
    "label": "Show Price",
    "format": "boolean"
  },
  "showPromiseTag": {
    "label": "Show Promise Tag",
    "format": "integer"
  },
  "specialIndustryLimit": {
    "label": "Special Industry Limit",
    "format": "boolean"
  },
  "status": {
    "label": "✅ Status",
    "format": "string"
  },
  "thousandLikePercent30": {
    "label": "Thousand Like Percent30",
    "format": "number"
  },
  "tradeType": {
    "label": "Trade Type",
    "format": "string"
  },
  "type": {
    "label": "Type",
    "format": "array"
  },
  "userId": {
    "label": "User Id",
    "format": "string"
  },
  "userPageUrl": {
    "label": "User Page Url",
    "format": "string"
  },
  "userType": {
    "label": "User Type",
    "format": "integer"
  },
  "valid": {
    "label": "Valid",
    "format": "integer"
  },
  "videoClickMidNum": {
    "label": "Video Click Mid Num",
    "format": "integer"
  },
  "videoCpcBasePrice": {
    "label": "Video Cpc Base Price",
    "format": "string"
  },
  "videoCpcPerPrice": {
    "label": "Video Cpc Per Price",
    "format": "string"
  },
  "videoFinishRate": {
    "label": "Video Finish Rate",
    "format": "number"
  },
  "videoHundredLikePercent30": {
    "label": "Video Hundred Like Percent30",
    "format": "number"
  },
  "videoInterMidNum": {
    "label": "Video Inter Mid Num",
    "format": "integer"
  },
  "videoPrice": {
    "label": "Video Price",
    "format": "integer"
  },
  "videoPriceGtZero": {
    "label": "Video Price Gt Zero",
    "format": "boolean"
  },
  "videoReadCost": {
    "label": "Video Read Cost",
    "format": "string"
  },
  "videoState": {
    "label": "Video State",
    "format": "integer"
  },
  "videoThousandLikePercent30": {
    "label": "Video Thousand Like Percent30",
    "format": "number"
  }
}
```

## About this Actor

This example demonstrates how to use [Xiaohongshu KOL Analytics — Pugongying Creator API](https://apify.com/sian.agency/xiaohongshu-kol-analytics) with a specific input configuration. Visit the [Actor detail page](https://apify.com/sian.agency/xiaohongshu-kol-analytics) to learn more, explore other use cases, and run it yourself.