📕 Xiaohongshu (RedNote / 小红书) Scraper API Suite: Viral Notes, Trends, Creator KOL Profiles, Comments & Live Rooms ($1 / 1K)
Cookieless Xiaohongshu (小红书 / RedNote) 5-Engine Data Extraction Suite on Apify. Extract trending viral notes, unwatermarked HD videos & image galleries, KOL creator portfolios, nested comment trees with buyer-intent tags, and real-time e-commerce live rooms with zero login or cookies required.
🚀 Try Live on Apify • 📓 Open in Google Colab • ⚡ Official n8n Creator Hub • 🔧 41 Free n8n Templates • 📖 Documentation & Schemas • 📚 Engineering Playbooks
⚡ 1-Click Free Trial: Test live queries using Apify's `$5` free monthly credit • Zero login or cookies required
This repository contains ready-to-run Python SDK scripts, an interactive 1-Click Google Colab notebook (notebooks/quickstart.ipynb), 9-node n8n automation workflow .json templates, AI Agent MCP configuration (.cursor/mcp.json), and sample output datasets (JSON & CSV):
- 📓 1-Click Interactive Google Colab Notebook: Open
notebooks/quickstart.ipynbdirectly in your browser via Google Colab ↗ to inspect sample DataFrames and test live API queries with zero local setup. - 🤖 Cursor, Windsurf & Claude Code MCP Ready: Includes
.cursor/mcp.jsonpre-configured withhttps://mcp.apify.comso AI coding agents can invoke these UnitBytes scrapers natively. - 💡 Using n8n? Explore our official creator profile at n8n.io/creators/unitbytes or copy all 41 pre-built 9-node scraping workflows (
Ctrl+V) at unitbytes.com/n8n. - 📚 Engineering Playbooks: Social Commerce Playbook • KOL & Influencer Leads Playbook — or browse all guides at unitbytes.com/blog.
Launch pre-configured extraction templates directly in the Apify Cloud Console with zero parameter setup:
| Task Preset | Target Extraction Use Case | Direct Launch |
|---|---|---|
| Xiaohongshu Fashion & OOTD Trends Scraper (穿搭) | Extract viral OOTD outfits, Korean aesthetic styles, luxury streetwear, and seasonal fashion inspirations from Xiaohongshu RedNote with engagement rates and HD image galleries. | ⚡ Run Task Preset |
| Xiaohongshu Beauty & Skincare Scraper (美妆护肤) | Track trending cosmetic products, Asian skincare routines, makeup tutorials, and beauty consumer reviews on Xiaohongshu with purchase intent signals. | ⚡ Run Task Preset |
| Xiaohongshu Viral Video Extractor (无水印视频) | Extract direct MP4 video URLs, viral reels, and short video feeds from Xiaohongshu RedNote with video duration, high engagement ratios, and full transcripts. | ⚡ Run Task Preset |
| Xiaohongshu Food & Gourmet Scraper (美食探店) | Discover viral foodie spots, local dining guides, coffee shops, and recipes on Xiaohongshu with author location, ratings, and HD food photography. | ⚡ Run Task Preset |
| Xiaohongshu Travel & Outdoor Scraper (旅行户外) | Extract viral travel itineraries, hidden scenic gems, camping spots, and city weekend guides from Xiaohongshu with author geolocation and full tips. | ⚡ Run Task Preset |
| Xiaohongshu Home Decor Scraper (家居家装) | Collect minimalist interior design, cozy bedroom decor, apartment organization ideas, and modern lifestyle tips from Xiaohongshu RedNote. | ⚡ Run Task Preset |
| Scrape Xiaohongshu (RedNote) Brand Mentions & KOL Notes | Extract viral Xiaohongshu notes, creator metrics, unwatermarked gallery images, and 1080p video streams by keyword or URL without login. | ⚡ Run Task Preset |
| Extract Xiaohongshu (RedNote) Comments & Buyer Sentiment | Scrape top-level comments and nested replies from viral Xiaohongshu posts with reviewer IP region, like counts, and buying-intent signals. | ⚡ Run Task Preset |
| Audit Xiaohongshu (RedNote) KOL & Influencer Profiles | Extract creator bios, follower counts, total likes/collects, MCN agency tags, and recent note portfolios to vet RedNote influencers. | ⚡ Run Task Preset |
| Monitor Xiaohongshu (RedNote) Live Stream Commerce Rooms | Discover active Xiaohongshu live broadcasts, real-time viewer counts, host profiles, and direct 1080p FLV/HLS stream URLs. | ⚡ Run Task Preset |
| Engine | Apify Actor Slug | Primary Use Case | Key Extracted Fields | Starting Price |
|---|---|---|---|---|
| 🔥 Xiaohongshu Viral Trend Scraper | unitbytes/xiaohongshu-rednote-trend-scraper |
Discover viral notes across 20+ category channels (fashion, cosmetics, travel, food, etc.) |
Unwatermarked HD photos/MP4s, likedCount, collectedCount, commentCount, tags, and author card |
$0.0022 / item |
| 📕 Xiaohongshu All-in-One Scraper | unitbytes/xiaohongshu-scraper |
Unified multi-mode extraction (Trending Channels, Note Detail URLs, Creator Profiles, Comments & Live Rooms) | Full note metadata, engagement ratios, creator stats, and media galleries | $0.0022 / item |
| 💬 Xiaohongshu Comments & Sentiment Scraper | unitbytes/xiaohongshu-rednote-comments-scraper |
Extract nested post comments, buyer-intent questions, and IP region demographics | Comment text, sub-comments, likeCount, ipLocation, author profile, and sentiment tags |
$0.00249 / comment |
| 👤 Xiaohongshu Creator & KOL Profile Scraper | unitbytes/xiaohongshu-rednote-profile-scraper |
Influencer (KOL) vetting, follower/engagement benchmarking, and portfolio cataloging | Creator redId, fansCount, likedAndCollectedCount, verified badge, bio, and recent notes |
$0.005 / profile |
| 📡 Xiaohongshu Live Stream & Room Scraper | unitbytes/xiaohongshu-rednote-live-scraper |
Real-time e-commerce live room monitoring, viewer counts, and live chat buyer intent | roomTitle, onlineCount, host profile, https:// stream URLs, and live chat messages |
$0.0079 / room |
🚀 Xiaohongshu Trending, Live & Note Scraper (RedNote / 小红书) (unitbytes/xiaohongshu-rednote-trend-scraper)
The fastest Xiaohongshu (RedNote / 小红书 / XHS) trends, live streams & posts scraper on Apify. Extract 13 category explore feeds, active live streams (1080p FLV/HLS & e-commerce flags), and full note details from $0.0015/post with zero cookies.
- Pricing:
$0.0022 / item(Pay-Per-Event —$0.0022scraped note record (volume tiers from$0.0015)) - Cloud Console: https://apify.com/unitbytes/xiaohongshu-rednote-trend-scraper?fpr=939u3w&fp_sid=gh_xhs
- Full Documentation & Schema: https://unitbytes.com/actors/xiaohongshu-trend-scraper/
- n8n Workflow File:
n8n/xiaohongshu-trend-scraper-n8n-workflow.json - Engineering Playbook: How to Scrape Xiaohongshu (RedNote) Posts, Influencers & Comments (Zero-Login Guide)
- Zero-Cookie Autonomous Access: Extract real-time trend data without logging into personal Xiaohongshu accounts. Zero ban risk, zero session expiration.
- Deep Multimedia Normalization: Automatically extracts original unwatermarked 1080p photo carousels and high-bitrate MP4 video stream URLs.
- Comprehensive Interaction Metrics: Detailed likes, collections, comments, and share counts normalized into clean numeric types for instant analytics.
- Sub-Second Cloud Execution: Engineered with warm cloud workers and adaptive residential routing for 0.05-second startup latency.
| Parameter | Type | Default / Prefill | Description |
|---|---|---|---|
mode |
string |
trending |
Select what to extract. Tip: If you paste Note or Live URLs into 'Direct URLs' below, the scraper automatically extracts your URLs even if you leave this dropdown unchanged. |
channels |
array |
["homefeed_recommend"] |
Choose categories to scrape when Mode = Trending Category Feeds. |
startUrls |
array |
— | Paste Xiaohongshu Note URLs (copied via 'Share -> Copy Link' on XHS Web/App so ?xsec_token=... or xhslink.com is included) or Live Room URLs (xiaohongshu.com/livelist?...). |
maxItems |
integer |
30 |
Maximum number of notes or live stream rooms to extract. |
enrichDetails |
boolean |
True |
When enabled, fetches the full post body text, hashtags, exact timestamps, IP location, and watermark-free HD images / .mp4 video URLs. |
includeAuthorProfile |
boolean |
False |
When enabled, also enriches each note or live room with the creator's follower count, total likes/collects, Red ID, and bio. |
liveCategories |
array |
— | Leave empty to scrape All Live Streams automatically when Mode = Active Live Streams, or pick specific live channels. |
onlyEcommerceLive |
boolean |
False |
In Live Streams mode, filter to only keep live rooms with an active shopping cart (带货直播). |
proxyConfiguration |
object |
{"useApifyProxy": true, "apifyProxyGroups": ["RE |
Xiaohongshu requires Residential proxies (Hong Kong recommended). |
from apify_client import ApifyClient
APIFY_TOKEN = os.getenv("APIFY_API_TOKEN", "YOUR_APIFY_API_TOKEN")
if not APIFY_TOKEN or APIFY_TOKEN.startswith("YOUR_"):
raise SystemExit("Please set your Apify API token: export APIFY_API_TOKEN='apify_api_...'")
client = ApifyClient(APIFY_TOKEN)
run_input = {
"mode": "trending",
"channels": ["homefeed_recommend"],
"maxItems": 30,
"enrichDetails": True,
"includeAuthorProfile": False,
"onlyEcommerceLive": False
}
run = client.actor("unitbytes/xiaohongshu-rednote-trend-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item.get("title"), item.get("likedCount"), item.get("commentCount"), item.get("noteUrl")){
"itemType": "note",
"id": "660000000000000000000001",
"noteId": "660000000000000000000001",
"title": "秋季极简通勤穿搭分享|一周不重样胶囊衣橱",
"desc": "分享一套适合日常通勤的秋季极简胶囊衣橱搭配,羊毛大衣配直筒牛仔裤,舒适显气质。",
"type": "normal",
"likedCount": 12450,
"collectedCount": 5320,
"commentCount": 418,
"shareCount": 890,
"noteUrl": "https://www.xiaohongshu.com/explore/660000000000000000000001",
"coverUrl": "https://sns-webpic-qc.xhscdn.com/202610/example_cover_hd.jpg",
"images": [
"https://sns-webpic-qc.xhscdn.com/202610/example_slide_01.jpg",
"https://sns-webpic-qc.xhscdn.com/202610/example_slide_02.jpg"
],
"tags": [
"穿搭",
"秋季穿搭",
"胶囊衣橱"
],
"author": {
"id": "600000000000000000000001",
"nickname": "时尚达人_01",
"redId": "creator_demo_01",
"avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/600000000000000000000001.jpg",
"profileUrl": "https://www.xiaohongshu.com/user/profile/600000000000000000000001"
},
"scrapedAt": "2026-10-20T12:00:00Z"
}Q: How does the Xiaohongshu Trend Scraper discover viral notes? It extracts real-time trending notes across 13 native Xiaohongshu category explore feeds (Fashion, Beauty, Food, Travel, Home, Fitness, Tech) as well as keyword searches and live streams.
Q: What engagement velocity metrics are included per note? Every record includes likes, collects (bookmarks), comments, shares, engagement-to-follower ratios, hashtags, publish timestamps, and creator verification badges.
Q: Do I need cookies or a RedNote login to scrape trending feeds? No. All category explore feeds and keyword searches run cookieless in the cloud with managed proxy routing included.
Q: How much does Xiaohongshu trend extraction cost?
Pricing starts at $0.0022 per extracted item under Apify Pay-Per-Event billing, with zero monthly minimums.
The complete Xiaohongshu (RedNote / 小红书 / XHS) scraper on Apify. Extract trending category feeds, active live streams & e-commerce chat, creator & KOL leads, comments, and watermark-free HD photos & MP4 videos. 100% cookie-free. MCP & AI Agent ready.
- Pricing:
$0.0022 / item(Pay-Per-Event —$0.0022note / post extracted,$0.005creator profile intelligence,$0.001scraped comment (volume tiers from$0.0007)) - Cloud Console: https://apify.com/unitbytes/xiaohongshu-scraper?fpr=939u3w&fp_sid=gh_xhs
- Full Documentation & Schema: https://unitbytes.com/actors/xiaohongshu-scraper/
- n8n Workflow File:
n8n/xiaohongshu-scraper-n8n-workflow.json - Engineering Playbook: How to Scrape Xiaohongshu (RedNote) Posts, Influencers & Comments (Zero-Login Guide)
- All-in-One Dual Engine: Combines viral keyword search, explore trending feeds, and full creator profile audits in a single unified API.
- Influencer & KOL Intelligence: Extracts creator follower counts, total likes, engagement rates, Red ID, verification badges, and full note portfolios.
- Watermark-Free HD Media: Captures direct CDN links for full-resolution carousel photos and 1080p MP4 videos without platform watermarks.
- Buyer Sentiment & Intent: Analyzes consumer tags, purchase links, product mentions, and user feedback across APAC lifestyle niches.
| Parameter | Type | Default / Prefill | Description |
|---|---|---|---|
mode |
string |
trending |
Select your scraping workflow. Tip: If you paste Note, Creator, or Live URLs into 'Direct URLs' below, the router automatically detects the URL type even if you leave this dropdown unchanged. |
channels |
array |
["homefeed_recommend"] |
Choose categories to scrape for Trending Notes, KOL Lead Discovery, or Category Comment Sweeps. |
startUrls |
array |
— | Smart URL box: Paste Note Share Links, Creator Profile URLs, 24-character hex User IDs, or Live Stream URLs. Automatically detects the URL type and overrides the default category feed. |
maxItems |
integer |
30 |
Maximum number of notes, live rooms, or items to extract. |
enrichNoteDetails |
boolean |
True |
Fetch full post body text, hashtags, exact timestamps, IP location, and watermark-free HD images / .mp4 video URLs. |
includeAuthorProfile |
boolean |
False |
Also enrich each note or live room with the creator's follower count, total likes/collects, Red ID, and bio. |
maxCreators |
integer |
15 |
Maximum number of unique creators to extract when scraping Creator Profiles or KOL Leads. |
scrapePortfolio |
boolean |
True |
When scraping specific Creator Profiles, also extract their recent portfolio notes (up to ~30 recent notes via public SSR). |
maxNotesPerCreator |
integer |
15 |
Maximum recent portfolio notes to extract per creator (up to 35 via public SSR). |
maxCommentsPerNote |
integer |
0 |
Maximum top comments & replies to extract per note (in Comments mode, automatically defaults to 20 if left at 0). |
liveCategories |
array |
— | Leave empty to scrape All Live Streams automatically when Mode = Active Live Streams, or select specific live channels. |
onlyEcommerceLive |
boolean |
False |
In Live Streams mode, filter to only keep live rooms with an active shopping cart (带货直播). |
proxyConfiguration |
object |
{"useApifyProxy": true, "apifyProxyGroups": ["RE |
Xiaohongshu requires Residential proxies (Hong Kong recommended). |
from apify_client import ApifyClient
APIFY_TOKEN = os.getenv("APIFY_API_TOKEN", "YOUR_APIFY_API_TOKEN")
if not APIFY_TOKEN or APIFY_TOKEN.startswith("YOUR_"):
raise SystemExit("Please set your Apify API token: export APIFY_API_TOKEN='apify_api_...'")
client = ApifyClient(APIFY_TOKEN)
run_input = {
"mode": "trending",
"channels": ["homefeed_recommend"],
"maxItems": 30,
"maxCreators": 15,
"maxNotesPerCreator": 15,
"maxCommentsPerNote": 0
}
run = client.actor("unitbytes/xiaohongshu-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item.get("title"), item.get("likedCount"), item.get("commentCount"), item.get("noteUrl")){
"itemType": "note",
"id": "660000000000000000000001",
"noteId": "660000000000000000000001",
"title": "秋季极简通勤穿搭分享|一周不重样胶囊衣橱",
"desc": "分享一套适合日常通勤的秋季极简胶囊衣橱搭配,羊毛大衣配直筒牛仔裤,舒适显气质。",
"type": "normal",
"likedCount": 12450,
"collectedCount": 5320,
"commentCount": 418,
"shareCount": 890,
"noteUrl": "https://www.xiaohongshu.com/explore/660000000000000000000001",
"coverUrl": "https://sns-webpic-qc.xhscdn.com/202610/example_cover_hd.jpg",
"images": [
"https://sns-webpic-qc.xhscdn.com/202610/example_slide_01.jpg",
"https://sns-webpic-qc.xhscdn.com/202610/example_slide_02.jpg"
],
"tags": [
"穿搭",
"秋季穿搭",
"胶囊衣橱"
],
"author": {
"id": "600000000000000000000001",
"nickname": "时尚达人_01",
"redId": "creator_demo_01",
"avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/600000000000000000000001.jpg",
"profileUrl": "https://www.xiaohongshu.com/user/profile/600000000000000000000001"
},
"scrapedAt": "2026-10-20T12:00:00Z"
}Q: Do I need a Xiaohongshu (RedNote) account or +86 phone number? No. The Xiaohongshu All-in-One Scraper operates 100% zero-login in the cloud without personal cookies, QR code scans, or Chinese phone numbers.
Q: What modes are supported in the All-in-One Xiaohongshu Scraper? Supports keyword search, viral category explore feeds, direct note URLs, creator/KOL profile portfolios, and nested comment extraction in a single unified engine.
Q: Does it extract watermark-free HD images and video streams? Yes. Every note record includes high-resolution image galleries, direct video stream URLs, like/collect/comment/share counts, hashtags, and creator profile metadata.
Q: Can I filter Xiaohongshu search results by sort order or note type? Yes. Filter by General relevance, Most Popular (likes), or Latest posts, and scope results to Video notes or Image notes.
🚀 Xiaohongshu (RedNote / 小红书) Comments & Live Chat Scraper (unitbytes/xiaohongshu-rednote-comments-scraper)
The fastest and most affordable Xiaohongshu (RedNote / 小红书 / XHS) comments & live stream chat scraper. Extract note comments, nested replies (楼中楼), live room chat messages, fan-club badges, and buyer intent signals with zero cookies. MCP & AI Agent ready.
- Pricing:
$0.00249 / item(Pay-Per-Event —$0.00249scraped comment (volume tiers from$0.00199)) - Cloud Console: https://apify.com/unitbytes/xiaohongshu-rednote-comments-scraper?fpr=939u3w&fp_sid=gh_xhs
- Full Documentation & Schema: https://unitbytes.com/actors/xiaohongshu-comments-scraper/
- n8n Workflow File:
n8n/xiaohongshu-comments-scraper-n8n-workflow.json - Engineering Playbook: How to Scrape Xiaohongshu (RedNote) Posts, Influencers & Comments (Zero-Login Guide)
- Deep Nested Reply Trees: Scrape top-level comments and multi-level sub-comment replies with parent comment IDs and reply-to targeting.
- Consumer Sentiment & IP Geolocation: Extracts author IP location, user profile IDs, verified like counts, and comment timestamps for authentic consumer feedback analysis.
- Batch URL Ingestion: Provide lists of note URLs or shortlinks to scrape hundreds of viral posts simultaneously with automated retry mechanisms.
- Clean Tabular Output: Delivers one row per comment in flat format, ready for immediate sentiment analysis, LLM fine-tuning, or Excel reporting.
| Parameter | Type | Default / Prefill | Description |
|---|---|---|---|
mode |
string |
comments |
Choose between Post Comments & Replies or Real-Time Live Stream Chat. |
startUrls |
array |
[{"url": "https://www.xiaohongshu.com/explore/66 |
Paste one or more Xiaohongshu Post URLs (with ?xsec_token=... or xhslink.com/...) or Live Room URLs. Tip: If you add your own URLs here, the prefilled demo URL is automatically ignored. |
channels |
array |
— | Optional: Select one or more Xiaohongshu categories to automatically sweep comments across trending posts in those categories. |
maxCommentsPerNote |
integer |
20 |
Maximum comments to extract per post (up to ~20–25 top Page-1 hot comments + nested replies per post in cookie-free mode, or up to 2,000 comments across Category Sweeps / Live Chat). |
includeSubComments |
boolean |
True |
Extract nested inline replies under top-level comments. |
maxSubCommentsPerComment |
integer |
5 |
Maximum nested replies to include per top-level comment. |
proxyConfiguration |
object |
{"useApifyProxy": true, "apifyProxyGroups": ["RE |
Xiaohongshu requires Residential proxies (Hong Kong recommended). |
from apify_client import ApifyClient
APIFY_TOKEN = os.getenv("APIFY_API_TOKEN", "YOUR_APIFY_API_TOKEN")
if not APIFY_TOKEN or APIFY_TOKEN.startswith("YOUR_"):
raise SystemExit("Please set your Apify API token: export APIFY_API_TOKEN='apify_api_...'")
client = ApifyClient(APIFY_TOKEN)
run_input = {
"mode": "comments",
"startUrls": [
{
"url": "https://www.xiaohongshu.com/explore/660000000000000000000001?xsec_token=example_token_redacted&xsec_source=pc_feed"
}
],
"maxCommentsPerNote": 20,
"maxSubCommentsPerComment": 5,
"includeSubComments": True
}
run = client.actor("unitbytes/xiaohongshu-rednote-comments-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item.get("authorName"), item.get("content"), item.get("likeCount"), item.get("noteUrl")){
"itemType": "comment",
"isLiveChat": false,
"id": "660000000000000000000101",
"noteId": "660000000000000000000001",
"noteUrl": "https://www.xiaohongshu.com/explore/660000000000000000000001",
"authorName": "穿搭爱好者_02",
"content": "请问这款风衣是什么面料?165cm穿M码合适吗?",
"likeCount": 86,
"subCommentCount": 3,
"ipLocation": "上海",
"createTime": "2026-10-18T14:22:10Z",
"author": {
"id": "600000000000000000000002",
"nickname": "穿搭爱好者_02",
"avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/600000000000000000000002.jpg",
"profileUrl": "https://www.xiaohongshu.com/user/profile/600000000000000000000002"
},
"subComments": [
{
"id": "660000000000000000000102",
"content": "是精纺全棉防风面料,正肩版型选M码刚好合身。",
"likeCount": 24,
"ipLocation": "上海",
"createTime": "2026-10-18T14:35:00Z",
"author": {
"id": "600000000000000000000001",
"nickname": "时尚达人_01"
}
}
],
"scrapedAt": "2026-10-20T12:00:00Z"
}Q: Does this scraper extract both top-level comments and nested replies? Yes. For every Xiaohongshu note URL or note ID, the engine extracts top-level comments alongside nested sub-comment reply threads, parent comment IDs, and like counts.
Q: Does it capture commenter IP location tags and user profiles? Yes. Each comment record includes the author's nickname, user ID, avatar, regional IP location badge (e.g., Shanghai, Guangdong, US), timestamp, and attached comment images.
Q: Can I pass note URLs or search keywords to extract comments? Yes. Paste direct Xiaohongshu note links (including xhslink.com shortlinks) or run a keyword search to automatically harvest buyer sentiment and product questions.
Q: Do I need a Xiaohongshu login to extract deep comment trees? No. Comment and reply pagination is handled automatically in the cloud with zero account login required.
🚀 Xiaohongshu (RedNote / 小红书) Creator & KOL Leads Scraper (unitbytes/xiaohongshu-rednote-profile-scraper)
Extract Xiaohongshu (RedNote / 小红书 / XHS) user profiles, auto-discover KOL leads from trending categories & live streams, follower demographics, verification badges, and published note portfolios from $0.0035/profile. 100% cookie-free.
- Pricing:
$0.005 / item(Pay-Per-Event —$0.005creator profile intelligence,$0.0022portfolio note extracted (volume tiers from$0.0015)) - Cloud Console: https://apify.com/unitbytes/xiaohongshu-rednote-profile-scraper?fpr=939u3w&fp_sid=gh_xhs
- Full Documentation & Schema: https://unitbytes.com/actors/xiaohongshu-rednote-profile-scraper/
- n8n Workflow File:
n8n/xiaohongshu-rednote-profile-scraper-n8n-workflow.json - Engineering Playbook: How to Scrape Xiaohongshu (RedNote) Live Streams, 1080p Video & KOL Leads in 2026
- In-Depth Creator & KOL Intelligence: Extracts nickname, Red ID, User ID, bio, IP location, verification badges, follower count, and total likes and collects.
- Published Note Portfolio Auditing: Automatically harvests the creator's latest published notes with engagement metrics, cover photos, and viral scores.
- Deep Influencer Discovery Workflow: Pass profile URLs or user IDs in bulk to vet hundreds of APAC lifestyle, beauty, and fashion influencers in a single run.
- 100% Cookie-Free Execution: Run creator audits anonymously in the cloud without supplying personal Xiaohongshu accounts or mobile logins.
| Parameter | Type | Default / Prefill | Description |
|---|---|---|---|
mode |
string |
creatorLeads |
Choose whether to auto-discover KOL leads from category feeds, or scrape specific creators. Tip: If you paste Creator URLs or User IDs below, it automatically scrapes those creators even if you leave this dropdown unchanged. |
channels |
array |
["homefeed.fashion_v3"] |
Select Xiaohongshu categories to discover active creators from. |
includeLiveHosts |
boolean |
True |
When enabled in KOL Lead Discovery mode, also discovers active live stream hosts alongside category creators. |
creatorUrls |
array |
— | Paste Xiaohongshu profile URLs (https://www.xiaohongshu.com/user/profile/...), 24-character hex User IDs (e.g. 55a1ffc867bc65487fdf2943), or Note Share Links to extract the author's profile. |
maxCreators |
integer |
10 |
Maximum number of unique creator profiles to extract. |
scrapePortfolio |
boolean |
True |
Extract the creator's recent published notes (up to ~30 recent notes via public SSR). Note: In KOL Lead Discovery mode, defaults to fast profile-only extraction unless you also customize 'Max Recent Notes Per Creator' below. |
maxNotesPerCreator |
integer |
15 |
Maximum number of recent portfolio notes to extract per creator (public SSR provides up to ~30 recent notes per profile). |
enrichNoteDetails |
boolean |
True |
Fetch full note text, tags, and HD media for portfolio notes when an xsec_token is available. |
proxyConfiguration |
object |
{"useApifyProxy": true, "apifyProxyGroups": ["RE |
Xiaohongshu requires Residential proxies (Hong Kong recommended). |
from apify_client import ApifyClient
APIFY_TOKEN = os.getenv("APIFY_API_TOKEN", "YOUR_APIFY_API_TOKEN")
if not APIFY_TOKEN or APIFY_TOKEN.startswith("YOUR_"):
raise SystemExit("Please set your Apify API token: export APIFY_API_TOKEN='apify_api_...'")
client = ApifyClient(APIFY_TOKEN)
run_input = {
"mode": "creatorLeads",
"channels": ["homefeed.fashion_v3"],
"maxCreators": 10,
"maxNotesPerCreator": 15,
"includeLiveHosts": True,
"scrapePortfolio": True
}
run = client.actor("unitbytes/xiaohongshu-rednote-profile-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item.get("nickname"), item.get("redId"), item.get("fansCount"), item.get("likedAndCollectedCount")){
"itemType": "creator_profile",
"id": "600000000000000000000005",
"nickname": "时尚达人_05",
"redId": "creator_demo_03",
"bio": "分享日常穿搭与生活美学 商务合作私信",
"avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/1000/600000000000000000000005.jpg",
"gender": "female",
"ipLocation": "上海",
"locationDetails": {
"raw": "上海",
"country": "中国",
"province": "上海",
"city": "上海"
},
"verification": {
"badge": "Pro Creator",
"isVerified": true,
"type": "profession",
"desc": "小红书知名时尚博主"
},
"followerCount": 10000,
"followerCountFormatted": "10K+",
"followerCountDisplay": "1万+",
"followingCount": 194,
"totalLikesAndCollects": 1820000,
"likedCount": 1140000,
"collectedCount": 680000,
"notesCount": 412,
"profileUrl": "https://www.xiaohongshu.com/user/profile/600000000000000000000005",
"scrapedAt": "2026-10-20T08:00:00.000Z"
}Q: What creator and KOL metrics are extracted from Xiaohongshu profiles? Extracts nickname, Red ID, bio, verified badge/institution, MCN agency name, IP location, follower count, following count, total likes & collects, and paginated note portfolios.
Q: Can I evaluate KOL engagement rates before sponsoring an influencer? Yes. By comparing the creator's follower count against the like, collect, and comment counts across their recent notes, agencies can immediately spot fake followers and high-converting KOLs.
Q: What profile input formats are accepted? Pass full Xiaohongshu user profile URLs (xiaohongshu.com/user/profile/...), mobile share shortlinks (xhslink.com/...), or 24-character hexadecimal user IDs.
Q: How is the Xiaohongshu Profile Scraper billed?
Billed per profile/note extracted under Apify Pay-Per-Event ($0.025 per profile) with zero login or proxy setup required.
🚀 Xiaohongshu (RedNote / 小红书) Live Stream & Commerce Scraper (unitbytes/xiaohongshu-rednote-live-scraper)
The fastest Xiaohongshu (RedNote / 小红书 / XHS) Live Stream & Live Commerce scraper. Extract active live rooms across all 7 live categories, 1080p FLV & HLS (.m3u8) stream URLs, concurrent viewers, e-commerce goods flags, real-time live chat, and host KOL profiles.
- Pricing:
$0.0079 / item(Pay-Per-Event —$0.0079scraped live stream room (with 1080p flv/hls stream & chat),$0.0035scraped live chat message (in live chat mode),$0.0059enriched host kol profile (volume tiers from$0.0025)) - Cloud Console: https://apify.com/unitbytes/xiaohongshu-rednote-live-scraper?fpr=939u3w&fp_sid=gh_xhs
- Full Documentation & Schema: https://unitbytes.com/actors/xiaohongshu-rednote-live-scraper/
- n8n Workflow File:
n8n/xiaohongshu-rednote-live-scraper-n8n-workflow.json - Engineering Playbook: How to Scrape Xiaohongshu (RedNote) Live Streams, 1080p Video & KOL Leads in 2026
- All 7 Official RedNote Live Categories (/livelist): Sweep active live broadcasts across all 7 official Xiaohongshu Live channels including Fashion, Beauty, Food, Lifestyle, Entertainment, and Knowledge.
- Direct 1080p .flv & .m3u8 (HLS) Video Stream Links: Extracts primary and backup 1080x1920 H.264 .flv and .m3u8 live stream URLs ready for ffmpeg recording, Whisper ASR transcription, or multimodal AI analysis.
- Native E-Commerce Live Shopping Flags (hasGoods): Automatically surfaces active e-commerce broadcasters (买手直播 / 店播) with live shopping carts enabled (hasGoods: true) alongside concurrent and total viewer counts.
- Real-Time Live Room Chat & Buyer Intent Keywords: Captures live viewer messages (liveChatMessages), room-level buyer intent prompts (buyerIntentKeywords), and viewer fan-club loyalty badges (fansGroup).
| Parameter | Type | Default / Prefill | Description |
|---|---|---|---|
mode |
string |
live |
Live = scrape active Xiaohongshu Live Stream rooms (with 1080p .flv & .m3u8 video stream URLs, concurrent viewers, e-commerce goods status, embedded chat, and host KOL profiles). |
liveCategories |
array |
["0"] |
Select which Xiaohongshu Live channels (/livelist) to sweep for active live broadcasts, e-commerce hosts (hasGoods), 1080p video streams, and live chat. |
startUrls |
array |
— | Optional: paste Xiaohongshu live URLs such as 'https://www.xiaohongshu.com/livelist?channel_id=0&channel_type=web_live_list', room URLs with 'room_id=...', or bare 18-19 digit numeric room IDs. Leave empty to sweep the selected Live Stream Categories above. |
maxItems |
integer |
27 |
Maximum number of live stream rooms (or standalone chat messages when Mode = Live Chat) to extract. Supports multi-page cursor pagination across active broadcasts. |
includeLiveChat |
boolean |
True |
When enabled, queries each live room's real-time chat feed to attach active viewer messages, fan-club badges (fansGroup), and buyer intent keywords. |
includeAuthorProfile |
boolean |
False |
When enabled, enriches each live broadcaster's author object with their full KOL profile metrics (followerCount, followerCountFormatted, totalLikesAndCollects, redId, bio, verification). |
onlyEcommerceLive |
boolean |
False |
When enabled, filters to only keep active live broadcast rooms with an e-commerce shopping cart (hasGoods = true). |
proxyConfiguration |
object |
{"useApifyProxy": true, "apifyProxyGroups": ["RE |
Pre-configured with Apify Residential (Hong Kong) for reliable access. |
from apify_client import ApifyClient
APIFY_TOKEN = os.getenv("APIFY_API_TOKEN", "YOUR_APIFY_API_TOKEN")
if not APIFY_TOKEN or APIFY_TOKEN.startswith("YOUR_"):
raise SystemExit("Please set your Apify API token: export APIFY_API_TOKEN='apify_api_...'")
client = ApifyClient(APIFY_TOKEN)
run_input = {
"mode": "live",
"liveCategories": ["0"],
"maxItems": 27,
"includeLiveChat": True,
"includeAuthorProfile": False,
"onlyEcommerceLive": False
}
run = client.actor("unitbytes/xiaohongshu-rednote-live-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item.get("roomTitle"), item.get("onlineCount"), item.get("totalViewerCount"), item.get("roomUrl")){
"itemType": "live_room",
"type": "live",
"id": "570505062122631608",
"roomId": "570505062122631608",
"title": "秋冬赴暖|设计师质感衣橱专场",
"nickname": "时尚达人_03",
"profileUrl": "https://www.xiaohongshu.com/user/profile/600000000000000000000003",
"followerCount": 100000,
"likedCount": 5280,
"commentCount": 18,
"category": "All (全部)",
"categoryId": "0",
"url": "https://www.xiaohongshu.com/livelist?channel_id=0&channel_type=web_live_list&room_id=570505062122631608",
"coverUrl": "https://sns-img-qc.xhscdn.com/1040g2jo31livecover.jpg",
"isLive": true,
"hasGoods": true,
"isPaidLive": false,
"viewersTotalUv": 14820,
"viewersConcurrent": 412,
"displayCount": 412,
"roomPv": 14820,
"displayLikesCount": "5280",
"displayViewerCount": "1.4万观看",
"displayMemberCount": "412人在线",
"roomStatus": 2,
"monetizeType": 1,
"hotValue": 14820,
"pinnedAnnouncement": "新进直播间的姐妹点点关注,领30元粉丝券!",
"buyerIntentKeywords": [
"身高体重穿什么码",
"几号链接",
"划算"
],
"liveChatCount": 18,
"liveChatMessages": [
{
"id": "570505091842103219",
"text": "求3号同款链接,平时穿M码合适吗?",
"originLanguage": "zh-CN",
"author": {
"id": "600000000000000000000004",
"nickname": "时尚达人_04",
"avatar": "https://sns-avatar-qc.xhscdn.com/avatar/600000000000000000000004.jpg",
"avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/600000000000000000000004.jpg",
"ipLocation": "",
"profileUrl": "https://www.xiaohongshu.com/user/profile/600000000000000000000004"
},
"fansGroup": {
"groupName": "梨梨铁粉团",
"fansLevel": 6,
"intimateName": "铁粉",
"activeFans": true,
"hasJoined": true
}
}
],
"streamInfo": {
"flvUrl": "https://live-source-play.xhscdn.com/live/570505062122631608.flv",
"hlsUrl": "https://live-source-play.xhscdn.com/live/570505062122631608.m3u8",
"backupUrls": [
"https://live-source-play-hw.xhscdn.com/live/570505062122631608.flv",
"https://live-source-play-hw.xhscdn.com/live/570505062122631608.m3u8"
],
"width": 1080,
"height": 1920,
"codec": "h264",
"maxBitrate": 0,
"quality": "HD"
},
"author": {
"id": "600000000000000000000003",
"nickname": "时尚达人_03",
"redId": "creator_demo_02",
"avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/600000000000000000000003.jpg",
"profileUrl": "https://www.xiaohongshu.com/user/profile/600000000000000000000003",
"followerCount": 100000,
"followerCountFormatted": "100K+",
"totalLikesAndCollects": 842150,
"isVerified": true
},
"scrapedAt": "2026-10-20T12:00:00.000000+00:00"
}Q: Can this Actor extract playable 1080p live stream URLs from Xiaohongshu? Yes. Every active broadcast record includes direct 1080p Open-GOP FLV and HLS (.m3u8) video stream URLs alongside H.264 and H.265 codec metadata.
Q: What live commerce and room metrics are captured? Extracts room ID, title, live status, concurrent viewer count, total likes, host profile details, real-time chat messages, gift events, and featured e-commerce product cards.
Q: What inputs can I use to monitor Xiaohongshu live rooms? Pass direct live room share links (xhslink.com or xiaohongshu.com/hina/livestream/...), creator profile URLs, or discovery keywords to find active broadcasts.
Q: Do I need a Xiaohongshu account to monitor live streams? No. Live room discovery, stream URL resolution, and chat/commerce polling run 100% cookieless in the cloud.
Click Open in Google Colab ↗ (notebooks/quickstart.ipynb) to inspect the sample output DataFrame immediately and run live extractions in your browser without installing Python locally.
git clone https://github.com/unitbytes/Xiaohongshu-RedNote-Scraper-API.git
cd Xiaohongshu-RedNote-Scraper-API
pip install -r requirements.txt
export APIFY_API_TOKEN="your_apify_api_token"
python examples/run_xiaohongshu_trend_scraper.py- Open any
.jsonfile inside then8n/folder (or copy in 1 click from unitbytes.com/n8n / n8n.io/creators/unitbytes). - Press
Ctrl+V/Cmd+Vdirectly onto your n8n workflow canvas. - Configure your Apify API Token in the
HTTP Header Authcredential on Node2. Run UnitBytes (...)(and customize your search inputs in Node1. Configure Search & Rules), then click Test Workflow.
This repository includes a ready-to-use Model Context Protocol configuration at .cursor/mcp.json pointing to https://mcp.apify.com with this suite's UnitBytes actors pre-registered. Open this folder in Cursor or Windsurf to let your AI agent run live extractions and inspect schemas automatically.
Don't want to manage API tokens or scripts? UnitBytes Data Delivery provides ready-to-use CSV, Excel (.xlsx), Google Sheets, or Webhook feeds tailored to your exact target keywords, cities, or categories.
- 🌐 Request a Sample Dataset: https://unitbytes.com/#enterprise-intake
- 📧 Direct Engineering Contact: contact@unitbytes.com
- ⚡ Explore All 41 Scrapers: https://unitbytes.com/actors/
- 📚 Engineering Playbooks & Guides: https://unitbytes.com/blog/
- 🔗 Official n8n Creator Profile: https://n8n.io/creators/unitbytes/