Xiaohongshu KOL Analytics — Pugongying Creator Marketplace API 📊

🎯 Brand-side KOL intelligence on Xiaohongshu / RedNote — the same Pugongying data XHS uses to match brands with creators

Built for influencer agencies, brand teams, and KOL-matching SaaS that need clean, structured creator-marketplace data — fans demographics, ROI scores, growth history, similar-creator clustering, brand-filtered B2B discovery

---

🔎 What is the Xiaohongshu KOL Analytics — and when should you use it?

The Xiaohongshu KOL Analytics turns Xiaohongshu creator-marketplace profiles from Pugongying into clean, structured rows you can filter, export and feed straight into a spreadsheet, database or AI agent. No account, no portal API key, no browser automation to maintain.

Use it when you need: brand-side creator profiles from Pugongying, with fans count, RedNote handle, location, personal tags, and what a creator charges in CNY for a picture note and for a video note. Fans come broken down by age, gender, province, city, interest and device, and you can pull a 30 or 90-day series of either fans total or fan increase to see whether that audience is still growing. Cost-effectiveness rows give estimated CPM, read cost and surpass rate. Notes report read, like, save and comment counts, creators carry content and audience feature tags, and search shortlists filter on fans count, fans age band, fans gender, creator gender and content category.

Use something else when: the campaign runs on a different Chinese platform. Use Douyin Xingtu KOL Analytics for Douyin creators on the Xingtu marketplace, with CPM and CPE price tiers and audience demographics. Use Tencent Huxuan KOL Analytics for WeChat Video Account and Official Account creators on the Tencent Huxuan marketplace. This reads the brand-side marketplace only, so public notes, comments and consumer search results are outside it.

🤖 Use with AI agents

Already connected to the Apify MCP server? Just ask for this Actor by name: sian.agency/xiaohongshu-kol-analytics

Your agent can pay for its own runs. This Actor is eligible for agentic payments, so an agent can discover it, run it and settle the bill over x402 (USDC on Base) or Skyfire — without an Apify account or API token of its own. Billing is the same either way: per successful row, never for errors.

Otherwise copy this prompt into Claude, ChatGPT, Cursor or any MCP-enabled assistant:

I want brand-side Xiaohongshu creator data for campaign planning using the Apify Actor `sian.agency/xiaohongshu-kol-analytics`.

Use it when I need: brand-side creator profiles from Pugongying, with fans count, RedNote handle, location, personal tags, and what a creator charges in CNY for a picture note and for a video note. Fans come broken down by age, gender, province, city, interest and device, and you can pull a 30 or 90-day series of either fans total or fan increase to see whether that audience is still growing. Cost-effectiveness rows give estimated CPM, read cost and surpass rate. Notes report read, like, save and comment counts, creators carry content and audience feature tags, and search shortlists filter on fans count, fans age band, fans gender, creator gender and content category.

Don't use it when: the campaign runs on a different Chinese platform — use douyin-xingtu-kol-analytics or tencent-huxuan-kol-analytics instead.

How to call it: pick one `operation` per run. `bloggerSearch` takes an optional `keyword` plus `searchType`, `fansNumberLower`, `fansNumberUpper`, `fansAge`, `fansGender`, `gender` and `contentTag`, and paginates via `maxPages`. Every other operation takes a creator `userId`: `kolInfo`, `kolCoreData`, `kolDataSummary` (+`business`), `kolCostEffective`, `kolNoteRate`, `kolFansTrend` (+`dateType`, `increaseType`), `kolFansPortrait`, `kolFansSummary`, `kolContentTags`, `kolFeatureTags`, `similarKol`, and `kolNoteList` (+`pageSize`, `maxPages`). `pgyNoteDetail` needs both `userId` and `noteId`.

Start with this input:
{
  "operation": "bloggerSearch",
  "keyword": "美妆",
  "searchType": "NOTE",
  "fansNumberLower": 10000,
  "fansNumberUpper": 500000,
  "fansAge": "AGE_25_34",
  "fansGender": "FE_MALE_HIGH",
  "maxPages": 3
}

Ask me which niche keyword or creator ID to look up, and what fans-count and audience demographic range the shortlist should cover, then run the Actor and summarise the results as a table.

Things you can ask your agent for:

• Build a shortlist of beauty creators on RedNote with 10k to 500k fans whose audience is mostly women aged 25 to 34.
• Compare the estimated CPM and read cost of these five Xiaohongshu creators before we book any of them.
• Show the 90-day fan-growth curve and the province breakdown of this creator's audience.

Machine-readable API, MCP config and OpenAPI definition for this Actor are published at apify.com/sian.agency/xiaohongshu-kol-analytics.md.

📋 Overview

Most Xiaohongshu scrapers stop at the consumer surface — public notes, follower counts, search results. This actor goes deeper: it pulls the Pugongying (蒲公英) creator-marketplace data XHS uses internally to match brands with creators — pricing, audience demographics, ROI benchmarks, content-tag classifications, lookalike creator clustering.

Why teams choose this actor:

• ✅ 14 marketplace operations — KOL profile · core data · ROI scores · fans demographics · growth history · note rates · content tags · similar creators · brand-filtered B2B search · note-level performance · marketplace note detail
• 🎯 Zero overlap with our consumer-side Xiaohongshu RedNote Scraper — different fields, different audience, different price points. Pair them for full XHS coverage.
• 🔍 9-filter B2B Blogger Search — keyword, fans count range, fans age band, fans gender, creator gender, content category. Build qualified shortlists in minutes.
• 💰 ROI / cost-effectiveness scoring — Pugongying's own CPM / surpass-rate benchmarks per creator. Identify under-priced rising stars and over-priced veterans.
• 📊 Production-ready data shape — curated camelCase aliases (userId, nickname, redId, fansCount, picturePrice, videoPrice…) plus the raw upstream fields for power users
• 💵 Pay-per-result pricing — only charged for successful extractions, never for empty pages or errors
• 🚀 No API key, no setup, no proxies — paste a creator ID or keyword and run

---

✨ Features

Creator profile & marketplace metrics

• 👤 KOL Info — full Pugongying profile (handle, fans count, location, personal tags, prices for picture / video notes, cooperation state)
• 📊 KOL Core Data — core marketplace metrics + 15-day daily-data array (CPM, CPV, engagement rate)
• 📈 KOL Data Summary — aggregate summary by DAILY_NOTE or COOPERATE_NOTE business type
• 💰 KOL Cost-Effectiveness — picture & video read-cost, surpass-rate, CPM estimates (the highest-value B2B field)
• 📋 KOL Note Rate — note-performance rates segmented by content tag

Audience intelligence

• 📊 KOL Fans Trend — 30 or 90-day time-series of total fans OR fan-increase deltas
• 👥 KOL Fans Portrait — ages distribution, gender split, geo (provinces + cities), interests, devices
• 📊 KOL Fans Summary — fan-base headline: active rate, engagement rate, growth-rate beyond percentile

Content classification

• 🏷️ KOL Content Tags — Pugongying's content-category tag set for the creator
• 🏷️ KOL Feature Tags — audience-feature tag set

Discovery

• 🔁 Similar KOLs — XHS's own clustering output (~20 audience-overlapping creators per query)
• 🔍 Blogger Search — paginated B2B creator discovery with 9 filters (the headline use case)

Note-level data

• 📝 KOL Note List — paginated history of a creator's published notes with read / like / save / comment metrics, sponsored / video flags
• 📕 PGY Note Detail — marketplace-side detail view of a single note (richer than the public note view)

---

💡 Use cases

1. Influencer Agency Creator Vetting — pull full marketplace profiles before pitching XHS creators to brand clients. Fans demographics, ROI score, content tags, growth history — the same intel XHS uses to qualify them.
2. B2B Creator Discovery with Filters — search XHS creators with 9 brand-side filters: keyword, fans count range, fans age band, fans gender, creator gender, content category. Build qualified shortlists in minutes — not weeks of manual triage.
3. Audience Demographics for Campaign Fit — exact age + gender + geo distribution of any KOL's fans before paying for sponsored content. Critical for CPG, beauty, and fashion brands on RedNote.
4. Cost-Effectiveness & ROI Benchmarking — Pugongying's own cost-effectiveness scores and note-performance rates to benchmark creator pricing against historical performance.
5. Lookalike-Creator Expansion — feed one proven KOL into the similar-creator endpoint and get XHS's own clustering output. Scale successful campaigns to new but compatible creators.
6. China Market Entry & KOL Database Building — build proprietary KOL databases for matching SaaS, market research firms, or in-house brand teams entering the Chinese market.

---

🚀 How to use

1. Pick an operation from the dropdown — start with 🔍 Blogger Search to find creator IDs in your target niche.
2. Fill in the relevant input — usually a creator userId (24-char hex) or a search keyword.
3. For paginated operations (Blogger Search, KOL Note List), set max pages (default 3).
4. Run — clean, flat dataset out.

Example: Find beauty creators with majority female fans aged 25–34

{
  "operation": "bloggerSearch",
  "keyword": "美妆",
  "fansAge": "AGE_25_34",
  "fansGender": "FE_MALE_HIGH",
  "fansNumberLower": 10000,
  "fansNumberUpper": 500000,
  "maxPages": 3
}

Example: Pull full ROI intel on a single creator

{
  "operation": "kolCostEffective",
  "userId": "636a59a2000000002302963a"
}

Example: 30-day fans growth time-series

{
  "operation": "kolFansTrend",
  "userId": "636a59a2000000002302963a",
  "dateType": "DAY_30",
  "increaseType": "FANS_INCREASE"
}

---

💰 Pricing

Pay-per-result pricing. You only pay for successful extractions — never for failed pages, empty results, or invalid IDs.

Event	Price (Bronze tier)
Actor start	$0.020
KOL Info / Core Data / Data Summary / Fans Portrait / Fans Summary / PGY Note Detail	$0.060 / row
KOL Cost-Effectiveness / Note Rate	$0.080 / row (premium B2B fields)
Content Tags / Feature Tags	$0.040 / row
Blogger Search	$0.012 / row
Similar KOLs	$0.008 / row
Fans Trend	$0.005 / row
KOL Note List	$0.005 / row

Free and higher-tier prices are auto-laddered by Apify based on the Bronze anchor — free-tier callers get ~3× the Bronze rate (for cost containment) and gold-tier users get tapered discounts down to flat near upstream cost.

---

🔗 Pair with our other Xiaohongshu actor

This actor covers brand-side Pugongying data. For consumer-side XHS data (public notes, profiles, comments, content search), use our companion:

• 📕 Xiaohongshu RedNote Scraper — note details, user profiles, user note catalogs, note comments, search notes, search users

Zero endpoint overlap. Different fields. Different audiences. Different price points. Combine them for full XHS coverage.

---

🏗️ Output schema

Every row carries:

• _operation — which mode produced it (filter the dataset by this to split modes)
• _fetchedAt — ISO-8601 UTC timestamp
• _sourceUserId / _sourceNoteId / _sourceKeyword — source input
• _page — page number for paginated operations
• status — success | error
• errorMessage — translated user-friendly error message (only on error rows)

Operation-specific fields are spread alongside the curated aliases — see dataset_schema.json for the full field reference.

---

🧰 Built for production

• Retry-resilient — automatic retry on transient HTTP 5xx and envelope code 301 ("FAILED, RETRY") with exponential backoff.
• Quota-safe failover — silent secondary failover wired in for HTTP 402/403/408/429 quota signals.
• HTTP/2 ready — modern axios stack, HTTPS auto-normalized on every CDN URL.
• 24-char hex IDs preserved — Xiaohongshu uses string IDs (not big-integers), so no precision-loss issues. bigIntSafeParse retained as a defensive guardrail for any large counters / timestamps.
• Pay-per-event — Apify monetization wired per-operation, so you only pay for rows you actually get back.

---

🌐 More by SIÁN Agency

• 📕 Xiaohongshu RedNote Scraper — consumer-side notes, profiles, comments
• 🎥 Kwai & Kuaishou Scraper — short-video & creator data
• 🛍️ Taobao & Tmall Product Scraper — China e-commerce
• 🛒 TikTok Shop Scraper — TikTok Shop products & sellers
• 🏠 Zoopla Property Scraper — UK real estate listings
• 🌐 Browse all SIÁN actors →

---

❓ FAQ

Do I need a Pugongying account or API key? No. Paste a creator userId or keyword, run, get clean data out.

How do I find a creator's Pugongying userId? Start with 🔍 Blogger Search to discover creators in your niche — the result rows contain userId fields ready to feed into single-creator operations. You can also pull a userId from an XHS profile URL: https://www.xiaohongshu.com/user/profile/{ID}.

What's the difference vs. your other Xiaohongshu actor? The RedNote Scraper returns consumer-side data — public notes, profiles, comments, search. This actor returns brand-side Pugongying data — pricing, audience demographics, ROI scores, content tags, brand-filterable creator search. Zero endpoint overlap.

Are prices in CNY or USD? Pugongying note prices (picturePrice, videoPrice, lowerPrice) are in CNY as listed by the creator on the marketplace. The Apify actor pricing (per-result charges) is in USD.

What's the rate limit? The actor handles transient HTTP 5xx and envelope code 301 with automatic retry + exponential backoff. We've measured zero rate-limit errors in normal use.

Can I get fan-growth data older than 90 days? The Pugongying upstream caps fans-trend at DAY_90. For longer windows, run the trend operation periodically and concatenate the time series in your own pipeline.

---

⚠️ Trademark Disclaimer

This is an independent scraping tool. It is not affiliated with, endorsed by, or sponsored by Xingyin Information Technology (Shanghai) Co., Ltd. or its Pugongying creator-marketplace platform. The Xiaohongshu®, RedNote®, 小红书®, and Pugongying®/蒲公英® names appear under nominative fair use to describe the data source. All trademarks are the property of their respective owners.

---

📜 Legal & ethics

This actor accesses publicly available Pugongying marketplace data. Use of the data is subject to:

• Local data-protection laws (GDPR, CCPA, China PIPL, etc.) — you are responsible for compliance in your jurisdiction.
• Xiaohongshu / Pugongying terms of service — respect the platform's terms.
• No spam / harassment — do not contact creators in violation of platform rules or anti-spam regulations.

For Apify's broader stance on web scraping legality, see this Apify blog post.

---

💬 Get in touch

• 📩 Email: apify@sian-agency.online
• 🌐 More actors: https://apify.com/sian.agency?fpr=sian
• ⭐ Leave a 5-star review — it helps us build more features for you.