RedNote Scraper & Xiaohongshu API ($1.50/1k) | 小红书 XHS

RedNote (Xiaohongshu / 小红书) Scraper: Keyword Search, Comments, Trends, Live & KOLs

The most comprehensive, lightning-fast, and cost-effective Xiaohongshu (RedNote / 小红书 / RED) scraper on Apify. Extract keyword search results (keywords), deep multi-page post comments & replies (250–1,000+/post), bare post URLs (zero xsec_token required), 13 category trending feeds, active live streams & live e-commerce chat, automated KOL / influencer leads, and creator portfolios—100% autonomously with Zero Login & Zero Cookies Needed.

[!IMPORTANT] 🆕 V2 Engine Upgrade — 7-in-1 Cookie-Free Extraction:

• Keyword Search (mode: "search"): Search any brand, product, or topic (300+ notes/keyword) with server-side sort (popularity_descending, general, time_descending) — prefilled in the Console UI for 1-click testing.
• Deep Multi-Page Post Comments (mode: "comments"): Paginate 250–1,000+ main comments + up to 3 top inline replies per comment (maxCommentsPerNote: 100 default in comments mode) directly from bare note URLs or keyword sweeps.
• Bare Post URLs & 24-Hex IDs: Paste plain xiaohongshu.com/explore/<id>, rednote.com/discovery/item/<id>, xhslink.com/..., or 24-character Note IDs — ?xsec_token is no longer required.

---

⚡ UnitBytes · Xiaohongshu (RedNote) & Asian E-Commerce Ecosystem
🌟 RedNote All-in-One 📍 You are here Search, Comments, Trends, Live & KOLs	📕 RedNote Search & Posts Keyword Search, Trends & Live 300+ notes/kw, bare URLs & HD media	👤 RedNote KOL & Creators KOL Leads & Profiles Followers, badges & portfolios	💬 RedNote Comments Comments & Live Chat Nested replies (楼中楼) & live chat	🔴 RedNote Live & Commerce 1080p FLV/HLS & Live Chat E-commerce rooms & buyer prompts

---

🌟 Why Choose This All-in-One Scraper?

Feature	This All-in-One Scraper	Standard Guest Scrapers	Cookie-Based Scrapers
Built-in Modes	7 Modes: search, trending, live, creatorLeads, creators, notes, comments	Category Feeds Only	Requires User Cookies
Keyword Search (search)	✅ 300+ Notes/Keyword + Server-Side sort & noteType	❌ Not Supported	Fragile Cookie Required
Deep Post Comments (comments)	✅ 250–1,000+ Comments/Post + Up to 3 Top Inline Replies (Zero xsec_token)	❌ Not Supported	Fragile Cookie Required
Live Stream Discovery (live)	✅ All 7 Categories (Active Broadcasts), 1080p FLV/HLS, hasGoods & Live Chat	❌ Not Supported	❌ Not Supported
KOL Lead Generation (creatorLeads)	✅ Auto-Discovers Creators by Keyword, Category Feeds & Live Streams	Category Feeds Only	Manual Profile Links
Pricing Model	Pay-Per-Event (PPE)	Monthly Subscriptions ($20–$80/mo)	Compute + Rental Fees
Startup Fee	$0.00001 (Virtually $0.00)	Upfront Compute or Flat Fees	High Setup Fees
Cost per Note / Live Room	$0.0022 / item	Pay compute time ($0.01+/note)	$0.05 / query
Cost per Creator Profile	$0.005 / profile	$0.20 – $1.00 / creator	$0.50 – $2.00 / profile
Account / Cookies	None (100% Zero Cookies Needed)	None	User Must Supply Fragile Cookies
Cold-Start Speed	<1s (Ultra-Lean 256MB RAM Tier)	10–30s Heavy Chromium Warmup	15–30s Browser Delay

---

🚀 7 Powerful Modes in One Actor

1. search — Keyword Search (keywords):

   • Paginate deeply across Xiaohongshu keyword search results (300+ notes per keyword) with native sorting (popularity_descending, general, time_descending) and media format filtering (all, video_only, image_only).
   • Extracts full untruncated descriptions, hashtags, exact likes/collects/comments/shares, 24-hex creator IDs, HD image galleries, and watermark-free MP4 videos.

2. trending — Real-Time Category Trending Feeds:

   • Paginate deeply across Xiaohongshu's 13 official recommendation channels: homefeed_recommend (All Trending), homefeed.fashion_v3 (Fashion & OOTD), homefeed.cosmetics_v3 (Beauty & Skincare), homefeed.food_v3 (Food & Dining), homefeed.travel_v3 (Travel & Outdoors), homefeed.household_product_v3 (Home & Lifestyle), homefeed.gaming_v3 (Gaming & Anime), homefeed.fitness_v3 (Fitness & Wellness), homefeed.movie_and_tv_v3 (Movies & TV), homefeed.career_v3 (Career & Study), homefeed.love_v3 (Relationships), homefeed.pet (Pets & Animals), and homefeed.video_v3 (Trending Videos).
   • Optional one-click deepCreatorAudit or includeAuthorProfile to enrich creator follower counts alongside viral posts.

3. live — Live Stream & E-Commerce Discovery (Xiaohongshu Live):

   • Continuously paginate active Xiaohongshu live broadcasts across 7 live categories (All, Gaming, Talent & Beauty, Lifestyle, Crafts & Hobbies, Tech & Finance, Sports & Outdoors).
   • Extracts real-time total viewers (viewersTotalUv), concurrent viewers (viewersConcurrent), total room views (roomPv), hotness score (hotValue), e-commerce shopping cart flag (hasGoods), 1080p .flv and .m3u8 HLS stream URLs, host profile & follower counts, buyer intent prompts (buyerIntentKeywords), and real-time live chat messages (liveChatMessages).

4. creatorLeads — Automated Influencer & KOL Discovery:

   • Automatically sweeps your target Search Keywords (keywords), Category Channels (channels), and/or Live Stream categories, deduplicates discovered 24-character creator IDs, and enriches full KOL profiles (followers, exact total likes & collects, verification badges, IP location, bio, and optional recent notes).

5. creators — Creator Profile & Portfolio Audit:

   • Pass direct creator profile URLs (xiaohongshu.com/user/profile/...), mobile share links (xhslink.com/...), or 24-character userIds to extract full profile intelligence and recent published notes.

6. notes — Direct Note & Media Extraction:

   • Extract full post text, hashtags, engagement metrics, buyer sentiment signals, uncompressed HD photo galleries (https://sns-img-qc.xhscdn.com/...), and watermark-free MP4 video URLs from direct note URLs (explore/<note_id> with or without ?xsec_token=...) or xhslink.com share links.

7. comments — Deep Multi-Page Note Comments & Replies Extraction:

   • Paginate deeply across 250–1,000+ top-level comments plus up to 3 top inline replies per comment (楼中楼), commenter 24-hex author IDs, IP locations, timestamps, and purchase intent signals from bare note URLs, search keywords, or trending channels.

---

⚡ Cookie-Free Architecture & Extraction Scope

This Actor uses a 100% Guest-Native, Zero-Cookie Architecture designed for maximum stability and zero account risk:

• Deep Pagination Across Keyword Search, Category Feeds & Live Streams: Each search keyword paginates up to ~300–440 unique notes (up to 25 pages); pass multiple narrower keywords (up to 50 keywords/run, maxItems up to 10,000) to scale into the thousands, and combine sort: "time_descending" + ISO publishedAt to filter by publish date window. Category feeds (13 official channels) and Live Stream categories (7 channels) likewise paginate 100+ unique items with zero login.
• Multi-Page Note Comments & Bare Note URLs: Direct Note URLs (https://www.xiaohongshu.com/explore/<note_id>, up to 100 URLs/run) work without ?xsec_token=..., paginating 250–1,000+ main comments plus up to 3 top inline replies per comment (subCommentCount reports the full thread reply count; maxCommentsPerNote counts root + inline replies combined, so set includeSubComments: false for root comments only; expanding 4th+ sub-replies requires a logged-in Xiaohongshu account). Keyword/category comment sweeps sample up to 15 top matching posts per run.
• Creator Portfolio Depth: Public profiles return the creator's latest ~30 portfolio posts from Page 1 of their public profile without requiring user cookies (older historical pagination requires an authenticated account), along with normalized followerCount (followerCountDisplay) and exact totalLikesAndCollects when available.
• Real-Time Live Stream URLs: Direct 1080p .flv and .m3u8 (HLS) video URLs (streamInfo), hasGoods e-commerce flags, and liveChat cover currently active live broadcasts while the host is live (no ended VOD replays or closed-loop RedNote Shop checkout catalogs).

---

🎯 Who Uses This Data? (High-Value Use Cases)

• 🤝 MCNs & KOL / Influencer Recruiting: Auto-discover rising creators and active live shopping hosts across 13 lifestyle categories (creatorLeads), filter by verification badge (Pro Creator vs. Official Brand), and audit exact total likes & collects (totalLikesAndCollects) and engagement rates.
• 🛒 Live Commerce & E-Commerce Benchmarking: Monitor active shopping streams (hasGoods: true), track concurrent viewers (viewersConcurrent), and capture real-time audience sizing/pricing questions (buyerIntentKeywords & liveChatMessages).
• 🎙️ AI / ASR Multimodal Video & Stream Analysis: Feed watermark-free MP4 note videos and real-time 1080p .flv / .m3u8 HLS live broadcast streams directly into Whisper ASR, VLM, or LLM pipelines for automated script transcription and visual trend analysis.
• 📊 Consumer Social Listening & Sentiment Mining: Analyze buyer intent signals (sentiment), popular hashtags, and geographic IP distributions (ipLocation) across trending lifestyle posts and discussion threads.

---

📥 Input Settings & Parameters

Setting	Type	Default	Description
mode	Select	"trending" (API) / "search" (UI)	Primary operating mode: search, trending, live, creatorLeads, creators, notes, or comments.
keywords	Array	[]	Search keywords (e.g. ["Lululemon", "美妆", "露营"]) for search, creatorLeads, or comments sweep mode.
sort	Select	"popularity_descending"	Search sort order: popularity_descending (Most Popular), general (Relevance), or time_descending (Newest).
noteType	Select	"all"	Media format filter for search and trending modes: all, video_only, or image_only.
channels	Array	["homefeed_recommend"]	Category channels to scrape in trending, creatorLeads, or comments mode (select one or multiple of the 13 official channels).
liveCategories	Array	["0"]	Live stream categories for live mode: "0" (All), "1" (Gaming), "2" (Talent & Beauty), "3" (Lifestyle), "4" (Crafts & Hobbies), "5" (Tech & Finance), "6" (Sports & Outdoors).
onlyEcommerceLive	Boolean	false	When enabled in live mode, only returns live streams with active e-commerce shopping carts (hasGoods=true).
enrichLiveRoomDetails	Boolean	true	Fetches real-time live chat messages, buyer intent prompts, pinned announcements, and HLS .m3u8 URLs for each live room.
enrichLiveHostProfile	Boolean	false	Enriches the live streamer's full Xiaohongshu creator profile (followers, bio, verification badge).
includeLiveHosts	Boolean	true	In creatorLeads mode, also discovers active live stream hosts alongside category feed creators.
startUrls	Array	[]	Universal URL list: paste note URLs (xiaohongshu.com/explore/<id> or rednote.com/discovery/item/<id> — no ?xsec_token required), creator profile URLs (user/profile/...), live room links, or xhslink.com share links.
creatorUrls	Array	[]	Direct creator profile URLs or mobile share links (xhslink.com/...).
userIds	Array	[]	Direct 24-character hexadecimal user IDs (5b331070e8cd614138e4a9e5). Supported for creator profile resolution.
maxItems	Integer	30	Maximum total notes, live rooms, profiles, or comments to collect across the run.
maxCommentsPerNote	Integer	100 (comments mode) / 0	Maximum comments (root + inline replies combined; set includeSubComments: false for root comments only) per post (1 to 2,000 in comments mode).
maxCreators	Integer	10	Maximum creators to enrich in creatorLeads or creators mode (1 to 100).
maxNotesPerCreator	Integer	10	Maximum recent public portfolio notes to extract per creator (0 for profile stats only, up to 35 / ~30 recent public portfolio notes).
scrapePortfolio	Boolean	true	When scraping creators, extract their recent published notes.
enrichNoteDetails	Boolean	true	Fetch full note description, HD media galleries, and watermark-free MP4 video download links.
deepCreatorAudit	Boolean	false	In trending mode, automatically audits the creators behind discovered viral posts.
resumptionToken	String	""	Base64 resumption token from a previous run to continue pagination with 0 duplicates.
proxyConfiguration	Object	Residential (HK)	Apify Proxy configuration (useApifyProxy: true).

---

💻 Input Samples

Sample 1: Keyword Search with Untruncated Text & HD Media (mode: "search")

{
  "mode": "search",
  "keywords": ["Lululemon", "早秋穿搭"],
  "sort": "popularity_descending",
  "noteType": "all",
  "maxItems": 40,
  "enrichNoteDetails": true
}

Sample 2: Explore Real-Time Category Trending Feeds (mode: "trending")

{
  "mode": "trending",
  "channels": [
    "homefeed.fashion_v3",
    "homefeed.cosmetics_v3"
  ],
  "maxItems": 30,
  "enrichNoteDetails": true
}

Sample 3: Live Stream & E-Commerce Discovery (mode: "live")

{
  "mode": "live",
  "liveCategories": ["0", "2"],
  "onlyEcommerceLive": false,
  "enrichLiveRoomDetails": true,
  "enrichLiveHostProfile": true,
  "maxItems": 25
}

Sample 4: Automated KOL & Influencer Lead Discovery (mode: "creatorLeads")

{
  "mode": "creatorLeads",
  "keywords": ["Lululemon", "护肤"],
  "channels": [
    "homefeed.fashion_v3",
    "homefeed.cosmetics_v3"
  ],
  "includeLiveHosts": true,
  "maxCreators": 20,
  "scrapePortfolio": false
}

Sample 5: Creator Profile Intelligence & Recent Portfolio (mode: "creators")

{
  "mode": "creators",
  "creatorUrls": [
    { "url": "https://www.xiaohongshu.com/user/profile/58351cb382ec392d5f015f86" }
  ],
  "maxNotesPerCreator": 15,
  "scrapePortfolio": true
}

Sample 6: Multi-Page Post Comments from Bare Note URL (mode: "comments")

{
  "mode": "comments",
  "startUrls": [
    { "url": "https://www.xiaohongshu.com/explore/64256e08000000001300575e" }
  ],
  "maxCommentsPerNote": 100
}

---

📤 Output Formats & Dataset Samples

Sample 1: Live Stream Room Output (itemType: "live_room")

{
  "itemType": "live_room",
  "id": "570228761768989458",
  "roomId": "570228761768989458",
  "title": "早秋新款羊绒大衣专场 | 显瘦穿搭实测",
  "type": "live",
  "category": "Talent & Beauty (才艺颜值)",
  "categoryId": "2",
  "url": "https://www.xiaohongshu.com/livelist?channel_id=2&channel_type=web_live_list&room_id=570228761768989458",
  "coverUrl": "https://sns-img-qc.xhscdn.com/1040g2jo31livecover",
  "isLive": true,
  "hasGoods": true,
  "isPaidLive": false,
  "viewersTotalUv": 18420,
  "viewersConcurrent": 312,
  "displayCount": 1480,
  "roomPv": 18420,
  "displayLikesCount": "9650",
  "likedCount": 9650,
  "commentCount": 6,
  "hotValue": 42800,
  "pinnedAnnouncement": "欢迎进直播间的姐妹！身高体重打在公屏帮大家选尺码~",
  "buyerIntentKeywords": ["能穿", "什么码", "尺码", "身高", "多重"],
  "liveChatCount": 1,
  "liveChatMessages": [
    {
      "id": "1761038291042",
      "text": "165 105斤穿S还是M码？",
      "originLanguage": "zh-CN",
      "author": {
        "id": "5f0000000000000000000003",
        "nickname": "穿搭爱好者_01",
        "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31user.jpg",
        "profileUrl": "https://www.xiaohongshu.com/user/profile/5f0000000000000000000003"
      },
      "fansGroup": {
        "groupName": "枝枝铁粉",
        "fansLevel": 5,
        "intimateName": "枝枝铁粉",
        "activeFans": true,
        "hasJoined": true
      }
    }
  ],
  "streamInfo": {
    "flvUrl": "http://live-source-play.xhscdn.com/live/570228761768989458.flv",
    "hlsUrl": "http://live-source-play.xhscdn.com/live/570228761768989458.m3u8",
    "backupUrls": [],
    "width": 1080,
    "height": 1920,
    "codec": "h264",
    "maxBitrate": 0,
    "quality": "HD"
  },
  "author": {
    "id": "680000000000000000000002",
    "nickname": "美妆时尚主理人",
    "redId": "fashion_daily_01",
    "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31.jpg",
    "profileUrl": "https://www.xiaohongshu.com/user/profile/680000000000000000000002",
    "followerCount": 128500
  },
  "scrapedAt": "2026-10-20T08:00:00.000Z"
}

Sample 2: Trending Note Output (itemType: "note")

{
  "itemType": "note",
  "id": "64a7f30200000000160269ae",
  "title": "早秋高级感通勤穿搭 | 5套胶囊衣橱指南",
  "desc": "秋天第一波气质穿搭来啦！衬衫搭配西装裤，高级感拉满 #OOTD #秋季穿搭 #通勤穿搭",
  "type": "normal",
  "url": "https://www.xiaohongshu.com/explore/64a7f30200000000160269ae?xsec_token=AB4829fa...&xsec_source=pc_feed",
  "isDetailEnriched": true,
  "author": {
    "id": "5a0000000000000000000001",
    "nickname": "林小夏穿搭",
    "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/1000/5a0000000000000000000001.jpg",
    "profileUrl": "https://www.xiaohongshu.com/user/profile/5a0000000000000000000001",
    "redId": "linxiaoxia_ootd",
    "isVerified": true
  },
  "likedCount": 35200,
  "collectedCount": 21800,
  "commentCount": 1420,
  "sharedCount": 2890,
  "viralScore": 94620.0,
  "engagementRate": 74.18,
  "imageCount": 2,
  "hasVideo": false,
  "coverUrl": "https://sns-img-qc.xhscdn.com/1040g008323luhj1vnk5g5qi11c5jv001abram18",
  "images": [
    "https://sns-img-qc.xhscdn.com/1040g008323luhj1vnk5g5qi11c5jv001abram18",
    "https://sns-img-qc.xhscdn.com/1040g008323luhj1vnk5g5qi11c5jv002bcrbm29"
  ],
  "videoUrl": null,
  "ipLocation": "上海",
  "tags": ["OOTD", "秋季穿搭", "通勤穿搭"],
  "sentiment": {
    "hasPurchaseIntent": true,
    "hasInquiry": false,
    "hasPraise": true,
    "emojis": [],
    "intentKeywords": ["链接", "同款"]
  },
  "scrapedAt": "2026-10-20T08:00:00.000Z"
}

Sample 3: Creator & KOL Lead Output (itemType: "creator_profile")

{
  "itemType": "creator_profile",
  "id": "5a0000000000000000000001",
  "nickname": "林小夏穿搭",
  "redId": "linxiaoxia_ootd",
  "bio": "分享日常穿搭与生活美学 商务合作私信",
  "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/1000/5a0000000000000000000001.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/5a0000000000000000000001",
  "scrapedAt": "2026-10-20T08:00:00.000Z"
}

---

💰 Monetization & Pay-Per-Event (PPE) Pricing

This Actor operates under transparent, affordable Pay-Per-Event (PPE) billing:

Event	Price (USD)	Description
apify-actor-start	$0.00001	Virtually $0.00 barrier to launch runs.
note	$0.0022	Charged per trending note, portfolio post, or live stream room extracted.
profile	$0.005	Charged per creator profile or KOL lead enriched with followers, bio & badges.
comment	$0.001	Charged per comment, nested reply, or live chat message extracted.

---

🔗 The UnitBytes Xiaohongshu & Sourcing Ecosystem

• 🌟 RedNote (Xiaohongshu) All-in-One Scraper (📍 You are here): Unified 7-in-1 scraping for keyword search, multi-page comments, category trends, live streams, KOL leads, and creator analytics.
• 🔴 RedNote Live Stream & Commerce Scraper: Dedicated live broadcast discovery, 1080p .flv/.m3u8 stream extraction, e-commerce room filtering (hasGoods), and real-time live chat.
• 📕 RedNote Search & Post Scraper: Cookieless keyword search (300+ notes/kw), bare post URLs, 13-category explore feeds, live rooms, and watermark-free media downloads.
• 👤 RedNote Creator & KOL Leads Scraper: Automated KOL lead discovery by keyword, category feeds & live streams, plus deep creator profile intelligence.
• 💬 RedNote Comments & Replies Scraper: Multi-page post comment extraction (250–1,000+/post), top inline replies (楼中楼), real-time live room chat messages, and buyer sentiment scoring.
• 🇨🇳 1688 Factory Direct Scraper: Real-time Chinese factory pricing, SKU matrices, and MOQ sourcing specifications.
• 🌐 Alibaba Wholesale Scraper: Global B2B marketplace search and verified supplier intelligence.

---

💬 Support & Feature Requests

Need help configuring your run, requesting custom fields, or reporting an issue?

• 💬 Apify Issues: Open a ticket in the Apify Issues Tab

---

⚖️ Compliance & Privacy

This Actor extracts strictly publicly available data from Xiaohongshu pages. It does not log in, bypass authentication walls, or collect private user messages. Personal data is protected by regulations such as GDPR, CCPA, and PIPL—see Apify's guide on the legality of web scraping and ensure your usage complies with applicable data privacy laws.

Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Xiaohongshu (RED / 小红书 / Xingin Information Technology Co., Ltd.) or any of its subsidiaries or affiliates.

---

🤖 AI Agents, Claude, Cursor & Official Apify MCP (mcp.apify.com)

This Actor runs with LIMITED_PERMISSIONS and structured output schemas, making it natively compatible with Apify's Official Hosted MCP Server—with zero local Playwright browsers, zero +86 SMS/QR logins, and zero local server maintenance.

Connect Claude Desktop, Cursor, Windsurf, VS Code, or any MCP-compatible AI agent directly to this Actor via Streamable HTTP:

https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,unitbytes/xiaohongshu-scraper

Example mcp.json configuration (Cursor / Claude Desktop / VS Code):

{
  "mcpServers": {
    "unitbytes-rednote": {
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,unitbytes/xiaohongshu-scraper",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}