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

---

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