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

This actor reads the brand side of Xiaohongshu. It pulls Pugongying (蒲公英) creator-marketplace records — the ones XHS itself uses to match brands with creators. That means published rates, audience demographics, cost benchmarks, content-tag classifications and lookalike-creator clustering, rather than the public notes and follower counts a consumer-side scraper returns.

What you get:

• ✅ 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 every raw marketplace field 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 creators per query who share the same audience)
• 🔍 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)

---

🎬 Quick Start

Pick one of the fourteen operations, drop in a creator ID or a search keyword, and run. The Actor returns a flat dataset within seconds — no account or API key to set up on your side.

curl -X POST https://api.apify.com/v2/acts/sian.agency~xiaohongshu-kol-analytics/runs?token=YOUR_TOKEN \
-d '{"operation": "bloggerSearch", "keyword": "美妆"}'

---

🚦 Getting Started (3 Simple Steps)

Step 1: Pick an operation

Choose one of the fourteen modes from the Operation dropdown. Start with bloggerSearch if you don't have a creator ID yet.

Step 2: Fill in what that operation needs

Most operations just need a creator userId. Blogger Search takes an optional keyword plus filters instead.

Step 3: Run

Press Start. Rows land in your dataset as the marketplace answers each lookup.

That's it! In under a minute, you'll have:

• A flat, exportable dataset — CSV, JSON, or straight into your own pipeline
• Failed lookups called out with a plain-English reason, never silently dropped
• A run report showing what succeeded, what didn't, and what you were charged

---

📥 Input Configuration

Field	Type	Required	Description
operation	string (select)	Defaults to bloggerSearch	Which of the 14 marketplace operations to run
userId	string	Needed by every operation except Blogger Search	Pugongying creator ID
noteId	string	Needed only by PGY Note Detail	Marketplace note ID
keyword	string	Optional	Search keyword for Blogger Search — Chinese or English
searchType	string (select)	Optional	Match against note content (NOTE) or creator handle (NICKNAME)
fansNumberLower / fansNumberUpper	integer	Optional	Fans-count range filter for Blogger Search
fansAge / fansGender / gender	string (select)	Optional	Blogger Search demographic filters
maxPages	integer	Optional, defaults to 3	Pages to fetch for paginated operations

Example — search for creators:

{
  "operation": "bloggerSearch",
  "keyword": "美妆"
}

Example — pull one creator's ROI data:

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

---

🚀 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"
}

---

🏗️ 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.

---

💡 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 a creator who already performed into the Similar KOLs operation and read back XHS's own clustering output. Run the campaign that worked again, with people who reach the same readers.
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.

---

🔗 Integration examples

JavaScript / Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/xiaohongshu-kol-analytics').call({
  operation: 'bloggerSearch',
  keyword: '美妆',
  fansNumberLower: 10000,
  fansNumberUpper: 500000,
  maxPages: 3
});

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/xiaohongshu-kol-analytics').call(
    run_input={
        'operation': 'kolFansPortrait',
        'userId': '636a59a2000000002302963a',
    }
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~xiaohongshu-kol-analytics/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"operation": "kolCostEffective", "userId": "636a59a2000000002302963a"}'

Automation workflows (n8n / Zapier / Make)

1. Trigger — a schedule, a new row in your CRM, or a webhook from your campaign tool
2. HTTP Request — call the actor endpoint above with the creator ID or keyword from step 1
3. Process — map fansCount, picturePrice, videoPrice and the audience split onto your own fields
4. Action — write the shortlist to Google Sheets, Airtable or Notion, or post it to Slack for sign-off

A common pattern: run Blogger Search weekly on your target niche, diff the result against last week's sheet, and alert the team only on creators that are new or whose rates moved.

---

💰 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

Apify ladders the other plan tiers automatically from that Bronze anchor. Free-tier callers pay about 3× the Bronze rate; gold and above get tapered discounts down to the lowest rate on the ladder.

---

🔗 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

No endpoint overlap: the two actors return different fields, answer to different buyers and sit at different price points. Run both for full XHS coverage.

---

🧰 Built for production

• Transient failures are retried for you — a lookup that stumbles is repeated automatically with a growing delay, so a momentary blip does not cost you a creator.
• Failed lookups cost nothing — anything that comes back empty is written to the dataset with a plain-English reason and is never charged.
• IDs survive the round trip — creator and note IDs come back exactly as Xiaohongshu issues them, so nothing is mangled on the way into your spreadsheet or database.
• Every image URL comes back over HTTPS — avatars and note covers drop straight into a dashboard with no mixed-content warnings.
• A run report with every run — headline numbers, the shortlist in copy-paste form, what you were charged, and a ready-made retry input for anything that came back empty.
• Pay-per-result — billing is 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? There is no rate limit you need to manage. Transient failures are retried automatically with a growing delay, and we have measured no rate-limit errors in normal use.

Can I get fan-growth data older than 90 days? The Pugongying marketplace publishes fans-trend no further back than DAY_90. For longer windows, run the trend operation on a schedule and stitch the series together in your own pipeline.

---

🐛 Troubleshooting

Blogger Search returns nothing for my keyword

• Leave Search Type on "NOTE" — it matches the content creators publish. "NICKNAME" matches handles only, so a topic word usually matches nobody.
• Loosen the filters. A narrow fans-count window combined with an age band and a gender skew can empty a shortlist on its own.
• Try the Chinese term as well as the English one. Most niches are tagged in Chinese on the marketplace.

"Creator not found" on a userId that used to work

• The creator has usually left the marketplace or switched their profile to private. Run Blogger Search on the same niche to pick up a current ID.
• Check you pasted the 24-character ID and not the whole profile URL.

A run stopped earlier than the page count I set

• Free Apify plans receive up to 25 rows per run on this actor, and pagination stops there. A paid plan returns every row the marketplace has.
• Search results also end naturally: once the marketplace signals it has no more matches, the run stops rather than paying for empty pages.

Note prices look wrong

• Picture and video prices are in CNY, exactly as the creator listed them. They are not converted, and a creator who has not published a rate comes back empty rather than zero.

PGY Note Detail returns an error

• It needs both the creator ID and the note ID. Pull the note ID from a KOL Note List run on that same creator.

---

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

---

🤝 Support

Join our active support community

• 💬 Questions, bugs or feature requests: open an issue on the actor's Issues tab
• 📩 Email: apify@sian-agency.online
• 🌐 More actors: SIÁN Agency Store
• ⭐ Leave a 5-star review — it helps us build more features for you.

---

Built by SIÁN Agency | More Tools