Skip to content

About

The fastest zero-cookie Xiaohongshu (RedNote / 小红书) scraper & API on Apify. Scrape viral posts, hashtags, e-commerce buyer sentiment, KOL influencer metrics, and watermark-free HD photos & MP4 reels without login.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

📕 Xiaohongshu (RedNote / 小红书) Scraper API Suite: Viral Notes, Trends, Creator KOL Profiles, Comments & Live Rooms ($1 / 1K)

Available on Apify Open in Colab n8n Creator Hub Release Pricing

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


📕 Xiaohongshu (RedNote / 小红书) Scraper API Suite: Viral Notes, Trends, Creator KOL Profiles, Comments & Live Rooms (`$1 / 1K`)

Try it for Free
⚡ 1-Click Free Trial: Test live queries using Apify's `$5` free monthly credit • Zero login or cookies required


📦 Included in This Repository (Python Quickstarts, Google Colab, n8n Workflows, MCP & Sample Data)

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):

Extraction Engine 🐍 Python SDK Quickstart ⚡ n8n Workflow Template 📊 Sample Output 🚀 Cloud Console
Xiaohongshu Trending, Live & Note Scraper (RedNote / 小红书)
unitbytes/xiaohongshu-rednote-trend-scraper • Full Schema • Engineering Playbook
examples/run_xiaohongshu_trend_scraper.py n8n/xiaohongshu-trend-scraper-n8n-workflow.json JSON · CSV ⚡ Run on Apify
Xiaohongshu (RedNote / 小红书) Scraper: Trends, Live & KOLs
unitbytes/xiaohongshu-scraper • Full Schema • Engineering Playbook
examples/run_xiaohongshu_scraper.py n8n/xiaohongshu-scraper-n8n-workflow.json JSON · CSV ⚡ Run on Apify
Xiaohongshu (RedNote / 小红书) Comments & Live Chat Scraper
unitbytes/xiaohongshu-rednote-comments-scraper • Full Schema • Engineering Playbook
examples/run_xiaohongshu_comments_scraper.py n8n/xiaohongshu-comments-scraper-n8n-workflow.json
⚡ Official on n8n.io ↗
JSON · CSV ⚡ Run on Apify
Xiaohongshu (RedNote / 小红书) Creator & KOL Leads Scraper
unitbytes/xiaohongshu-rednote-profile-scraper • Full Schema • Engineering Playbook
examples/run_xiaohongshu_rednote_profile_scraper.py n8n/xiaohongshu-rednote-profile-scraper-n8n-workflow.json JSON · CSV ⚡ Run on Apify
Xiaohongshu (RedNote / 小红书) Live Stream & Commerce Scraper
unitbytes/xiaohongshu-rednote-live-scraper • Full Schema • Engineering Playbook
examples/run_xiaohongshu_rednote_live_scraper.py n8n/xiaohongshu-rednote-live-scraper-n8n-workflow.json JSON · CSV ⚡ Run on Apify

⚡ Pre-Configured 1-Click Task Presets

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

🧭 Which Xiaohongshu (RedNote / 小红书) Engine Should You Use? (5-Engine Suite)

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

🛠️ Extraction Engines in This Suite

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

Key Capabilities

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

⚙️ Input Parameters (Schema)

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

Python SDK Quickstart (examples/run_xiaohongshu_trend_scraper.py)

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"))

Sample Output Schema (samples/xiaohongshu-trend-scraper-sample.json)

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

Frequently Asked Questions

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.


🚀 Xiaohongshu (RedNote / 小红书) Scraper: Trends, Live & KOLs (unitbytes/xiaohongshu-scraper)

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.

Key Capabilities

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

⚙️ Input Parameters (Schema)

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

Python SDK Quickstart (examples/run_xiaohongshu_scraper.py)

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"))

Sample Output Schema (samples/xiaohongshu-scraper-sample.json)

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

Frequently Asked Questions

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)

Xiaohongshu (RedNote / 小红书) Comments & Live Chat 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.

Key Capabilities

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

⚙️ Input Parameters (Schema)

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

Python SDK Quickstart (examples/run_xiaohongshu_comments_scraper.py)

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"))

Sample Output Schema (samples/xiaohongshu-comments-scraper-sample.json)

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

Frequently Asked Questions

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)

Xiaohongshu (RedNote / 小红书) Creator & KOL Leads 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.

Key Capabilities

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

⚙️ Input Parameters (Schema)

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

Python SDK Quickstart (examples/run_xiaohongshu_rednote_profile_scraper.py)

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"))

Sample Output Schema (samples/xiaohongshu-rednote-profile-scraper-sample.json)

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

Frequently Asked Questions

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)

Xiaohongshu (RedNote / 小红书) Live Stream & Commerce 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.

Key Capabilities

  • 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).

⚙️ Input Parameters (Schema)

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.

Python SDK Quickstart (examples/run_xiaohongshu_rednote_live_scraper.py)

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"))

Sample Output Schema (samples/xiaohongshu-rednote-live-scraper-sample.json)

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

Frequently Asked Questions

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.


⚡ Quick Installation & Local Usage

1. Run Interactively in Google Colab (Zero Local Setup)

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.

2. Run Locally with Python (apify-client)

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

3. Import into n8n (Self-Hosted or Cloud)

  1. Open any .json file inside the n8n/ folder (or copy in 1 click from unitbytes.com/n8n / n8n.io/creators/unitbytes).
  2. Press Ctrl+V / Cmd+V directly onto your n8n workflow canvas.
  3. Configure your Apify API Token in the HTTP Header Auth credential on Node 2. Run UnitBytes (...) (and customize your search inputs in Node 1. Configure Search & Rules), then click Test Workflow.

4. Use with AI Coding Agents (Cursor, Windsurf & Claude Code MCP)

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.


💼 Need Done-For-You Datasets or Custom Pipelines?

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.

About

The fastest zero-cookie Xiaohongshu (RedNote / 小红书) scraper & API on Apify. Scrape viral posts, hashtags, e-commerce buyer sentiment, KOL influencer metrics, and watermark-free HD photos & MP4 reels without login.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages