# Changelog of Xiaohongshu (RedNote) Scraper — Notes, Users & Search (`sian.agency/xiaohongshu-rednote-scraper`) Actor

- **URL**: https://apify.com/sian.agency/xiaohongshu-rednote-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/sian.agency/xiaohongshu-rednote-scraper.md

## Changelog

All notable changes to **Xiaohongshu (RedNote) Scraper** will be documented in this file.

### \[2026-09-21]

- Marked the optional `xsec_token` input as secret so saved runs and task pages mask it.

### \[2026-08-24]

#### 📊 A run report that shows what you got — and what it cost

- **Redesigned HTML run report** — every run now opens with the numbers that matter (rows delivered, pages fetched, success rate), a one-click link straight into your dataset, and JSON / CSV download links next to it.
- **An itemised charges statement** — see exactly which events you were billed for on this run, at the price your Apify plan pays, with the next-tier saving spelled out alongside.
- **Failed items, with the fix** — anything that came back empty is listed with the reason and a copy-paste retry input, so a partial run takes one click to finish. Failed rows are never charged.
- **Copy-ready API and MCP snippets** — the exact call that reproduces this run, plus the MCP config that lets an AI agent run it in plain language.

#### 🖼️ Clearer results in the Apify Console

- **Note covers render as images** in the dataset Overview view instead of a raw URL — scan a keyword sweep visually before you export it.
- **One curated Overview view** replaces the earlier Overview / Users / Comments split, with labelled, icon-tagged columns for every operation.
- **The run report is linked from the Output tab**, so you never have to dig through the key-value store to find it.

#### ⚡ Easier first run

- **Run it with no input at all** — every field ships with a working prefill, so hitting Start returns a real Xiaohongshu keyword search immediately.
- **Straight answers when a run stops early** — free-plan result caps, daily run allowances and billing problems are now explained in the run log and on the report, with the exact step that lifts them.

#### 🎯 Use Cases

- 🔍 KOL & creator discovery on Xiaohongshu / RedNote — scan covers and engagement in the Console, export the shortlist
- 💰 Campaign budgeting — read the per-run charges statement before scaling a daily keyword sweep
- 🤖 Agent-driven research — hand the MCP snippet to Claude or ChatGPT and ask for RedNote data in plain language

### \[2026-07-13]

- ⚡ **Faster, more predictable runs.** Quick-start default now previews a single page (scale up any time via *Max pages*), and slow responses are cut off sooner with a tighter retry budget — runs finish reliably instead of stalling.

### \[2026-06-20]

- 🧯 **Graceful gateway-error handling.** Temporary error pages from the source are now retried and routed cleanly instead of surfacing as confusing parsing failures.

### \[2026-05-12]

#### 🎉 Xiaohongshu (RedNote) Scraper — Launch!

- **Six Scrapers in One Actor** — extract Xiaohongshu / RedNote (Little Red Book / 小红书 / XHS) note details, user profiles, user note catalogs, comments, and run keyword searches across notes and creators — pick the operation, paste the input, one clean dataset per run.
- **Note Detail Extraction** — full Xiaohongshu note payload by ID: title, description, images, like / save / share / comment counts, creator info, timestamps, video info for video notes.
- **User Profile Scraping** — full RedNote creator profile by user ID: fan count, follow count, note count, bio, verification badge, level, location, full avatar set, collected-content stats — ideal for KOL discovery.
- **User Note Catalog Mapping** — paginated history of any creator's notes (~20 notes/page) with engagement metrics for KOL audit and content-strategy reverse engineering.
- **Note Comment Mining** — paginated comments with author, IP location, like count, plus a top-5 reply sample per thread — feed sentiment models with structured comment data in a single row.
- **Search Notes by Keyword** — surface trending Xiaohongshu / RedNote notes in any niche (Chinese · English · mixed queries supported), ~20 results/page.
- **Search Creators by Keyword** — discover Chinese-market lifestyle KOLs by keyword with handle, RedID, verification, bio — ~20 results/page.
- **xsec_token Passthrough** — surfaces the per-note signed token in every search/list row so downstream detail / comment calls have higher reliability on geo-sensitive notes.
- **Retry-on-Transient-Failure** — retries with exponential backoff when the source is briefly unavailable, so you get clean rows instead of broken ones.
- **HTTPS-Normalized Media URLs** — every cover, avatar, and image URL is delivered ready to embed.
- **Cursor-Based Pagination + Safety Cap** — stream up to 50 pages per run with a single input parameter; auto-stop on last page.
- **Curated camelCase Aliases + Raw Fields** — clean `noteId` · `likedCount` · `collectedCount` · `userName` · `redId` · `notePageUrl` aliases for everyday users, plus every raw field spread alongside for power users.
- **HTML Run Report** — every run produces an HTML summary (success rate, errors, duration, inputs) saved to the key-value store.
- **Three Predefined Dataset Views** — Overview / Users / Comments — open the right table layout from the Apify Console with one click.

#### 💎 User Benefits

- **Save hours per KOL shortlist** — search Xiaohongshu / RedNote creators by keyword and rank by fans in 5 minutes instead of 5 hours of manual scrolling.
- **No API key, no setup, no proxies** — paste a note ID, user ID, or keyword and run. Production-ready from the first click.
- **Pay-per-result pricing** — only charged for successful extractions; never billed for empty pages or failed fetches.
- **Bulletproof data shape** — flat structure with both camelCase aliases and raw fields means every downstream tool (BigQuery, Notion, Airtable, Slack) just works.
- **Cross-operation joins that actually work** — stable `noteId` and `userId` across all operations let you pivot from search → detail → comments without ID-mapping headaches.
- **GDPR-friendly defaults** — extracts only publicly shared data; no private user info, no email or phone scraping.

#### 🎯 Use Cases

- 🔍 KOL & creator discovery (beauty / fashion / food / travel / lifestyle)
- 🌏 China market entry research and trend tracking
- 📊 Lifestyle trend intelligence (beauty, fashion, food, travel, parenting, fitness)
- 💬 Comment sentiment analysis on viral notes
- 📋 Creator catalog mapping & influencer due diligence
- 🛡️ Brand monitoring on China's #1 lifestyle-discovery platform