# Changelog of Xiaohongshu KOL Analytics β€” Pugongying Creator API (`sian.agency/xiaohongshu-kol-analytics`) Actor - **URL**: https://apify.com/sian.agency/xiaohongshu-kol-analytics/changelog.md - **Full Actor documentation**: https://apify.com/sian.agency/xiaohongshu-kol-analytics.md ## Changelog All notable changes to **Xiaohongshu KOL Analytics** will be documented in this file. ### \[2026-08-24] #### πŸ“Š A run report you can hand to a client - **Headline numbers first** β€” every run now opens with the figures a media planner decides on: median engagement rate, median followers, how many creators carry a published rate. The shortlist comes as copy-paste text, ready for a brief. - **Creator faces in the report** β€” avatars render as a contact sheet, so a shortlist reads like a shortlist instead of a wall of IDs. - **Published arithmetic** β€” every derived rate shows how it was computed from the rows in your dataset. Nothing is modelled, estimated or forecast. - **A charges statement with every run** β€” what you were billed, per event, with the price your plan would pay on the next tier up. - **Empty lookups come with a fix** β€” anything that returned nothing is listed with a reason and a ready-made retry input you can paste straight back into the actor. #### πŸ’Ž User Benefits - Share results without rebuilding them in a slide deck first. - See exactly what a run cost and why, on the same page as the data. - Recover a half-empty run in one paste instead of re-typing the whole input. #### 🏷️ Console clean-up - **Every dropdown option now carries an icon** β€” search type, audience age band, gender skew, trend window and note type all read at a glance in the Console. - **Clearer column labels in the dataset view** β€” median-interaction and revenue columns no longer wear a tag icon that suggested they were categories. - **Your plan and its limits are stated up front** β€” the run log now opens by naming your tier and what it includes, so a capped free run is never a surprise. ### \[2026-07-22] - πŸ” **Blogger Search now finds creators by topic out of the box.** The Search Type default changed from `NICKNAME` (matches a creator's handle) to `NOTE` (matches the content they publish) β€” searching "香水" or "Nike" used to return almost nothing because those aren't creator handles. - β†ͺ️ **Automatic fallback.** An explicit `NICKNAME` search that matches no handle now retries once as a content search instead of returning an empty result; those rows are marked with `_searchTypeUsed` and a short `_note` so the switch is visible. ### \[2026-06-20] - 🧯 **Temporary source errors handled gracefully.** A lookup that comes back as a temporary error page is retried, then reported in plain language rather than surfacing as a confusing parsing failure. ### \[2026-05-13] #### πŸŽ‰ Xiaohongshu KOL Analytics β€” Launch! - **14 Pugongying Marketplace Operations in One Actor** β€” extract brand-side creator-marketplace data from Xiaohongshu (RedNote): KOL profile, core data, cost-effectiveness, note rates, fans trend / portrait / summary, content / feature tags, similar creators, brand-filtered B2B search, KOL notes, and marketplace note detail. - **9-Filter Blogger Search** β€” paginated B2B creator discovery with keyword, fans count range, fans age band, fans gender, creator gender, content category. The headline use case for influencer agencies + brand teams. - **ROI / Cost-Effectiveness Scoring** β€” Pugongying's own CPM, surpass-rate, and picture/video read-cost benchmarks. Identify under-priced rising stars and over-priced veterans. - **Audience Demographics** β€” exact age + gender + geo + interest + device distribution per KOL. - **Lookalike-Creator Expansion** β€” `similarKol` returns XHS's own clustering output (~20 creators per query who share the same audience). - **Fans Growth Time-Series** β€” 30 or 90-day history of total fans OR fan-increase deltas. - **Production-ready data shape** β€” curated camelCase aliases (userId, nickname, redId, fansCount, picturePrice, videoPrice…) plus every raw marketplace field spread alongside. - **Pay-per-result pricing** β€” only charged for successful extractions, never for empty pages or errors. Bronze anchors: $0.005 (bulk paginated) β†’ $0.080 (premium ROI/note-rate). Apify auto-ladders free / silver / gold / platinum / diamond tiers. - **Zero overlap** with our shipped [Xiaohongshu RedNote Scraper](https://apify.com/sian.agency/xiaohongshu-rednote-scraper?fpr=sian) β€” different fields, different audience, different price points. Pair them for full XHS coverage. - **Transient failures retried for you** β€” a lookup that stumbles is repeated automatically with a growing delay, so a momentary blip does not cost you a creator. - **Every image URL comes back over HTTPS** β€” avatars and note covers drop straight into a dashboard with no mixed-content warnings. - **IDs survive the round trip** β€” creator IDs, note IDs and large counters come back exactly as Xiaohongshu issues them, so nothing is rounded off on the way into your spreadsheet. #### πŸ’Ž User Benefits - Vet a Xiaohongshu creator on audience, rates and real performance before a single yuan is committed. - Replace weeks of manual triage with a filtered shortlist you can export to CSV or Excel in one run. - Price a campaign against the marketplace's own cost benchmarks instead of a creator's asking rate. - No Pugongying account, no API key, no browser automation to maintain. #### 🎯 Use Cases - An influencer agency vets RedNote creators before pitching them to a brand client, with fans demographics and ROI scores in the same sheet. - A beauty brand's in-house team builds a shortlist of creators whose audience is mostly women aged 25–34, then checks the 90-day growth curve before booking. - A KOL-matching SaaS seeds its own China creator database from filtered marketplace search, and refreshes it on a schedule. - A market-research firm benchmarks creator pricing across a niche to spot under-priced rising stars. Built by [SIÁN Agency](https://apify.com/sian.agency?fpr=sian) β€” drop us a 5-star review if this saves you time.