Xiaohongshu Search, Trends & Live Scraper

RedNote (Xiaohongshu / 小红书) Keyword Search, Trends, Live Streams & Posts Scraper

📖 What is Xiaohongshu (RedNote)?

Xiaohongshu (小红书 / xiaohongshu.com)—internationally recognized as RedNote—is China's premier lifestyle discovery, trendsetting, and social commerce network, widely regarded as the Chinese blend of Instagram, Pinterest, and TikTok Live combined. With over 300 million monthly active users (MAU) sharing honest product reviews, fashion OOTDs, beauty routines, and live shopping broadcasts, Xiaohongshu is the undisputed birthplace of viral consumer trends across Asia.

⚡ What Does This Actor Do?

This Actor serves as a high-speed, fully autonomous data engine for Xiaohongshu (xiaohongshu.com). It enables e-commerce brands, dropshippers, marketing agencies, and researchers to extract keyword search results (keywords), 13 real-time category explore feeds, active live stream broadcasts, live e-commerce chat & buyer intent signals, influencer (KOL) engagement metrics, and watermark-free original HD photos and MP4 videos—100% autonomously on an ultra-lightweight 256 MB RAM tier with Zero Login & Zero Cookies Needed.

[!NOTE] Ultra-Fast, Lowest Cost & Zero Cookies Required: Engineered to run on Apify's leanest 256 MB RAM tier with instant sub-second startups. No personal accounts are at risk, no QR logins are required, and runs never break mid-scrape.

[!TIP] Explore the Complete UnitBytes Xiaohongshu (RedNote) Suite:

• 🌟 RedNote All-in-One Scraper (xiaohongshu-scraper) — Unified Category Trends, Live Streams, KOL Leads, Creator Profiles, and Post Comments in one Actor.
• 🔴 RedNote Live Stream & Commerce Scraper (xiaohongshu-rednote-live-scraper) — Dedicated 7-category live broadcast discovery, 1080p .flv/.m3u8 streams, e-commerce filtering (hasGoods), and real-time live chat.
• 👤 RedNote Creator & KOL Leads Scraper (xiaohongshu-rednote-profile-scraper) — Automated KOL lead discovery from category feeds & live streams, follower counts, verification badges & portfolio extraction.
• 💬 RedNote Comments & Live Chat Scraper (xiaohongshu-rednote-comments-scraper) — Note comments, nested reply trees (楼中楼), real-time live room chat messages, and buyer intent mining.

---

⚡ UnitBytes · Chinese E-Commerce & B2B Sourcing Ecosystem
🌐 Alibaba Wholesale Global B2B & MOQ Verified Suppliers & Audits	🇨🇳 1688 Factory Direct Domestic Factory Prices SKU matrices & FBA specs	📕 RedNote Trends & Live 📍 You are here 🌟 All-in-One · Creators · Comments	🐟 Goofish Products C2C Resale & Arbitrage Zero-login search engine	⭐ Goofish Sellers Merchant Due Diligence Zhima credit & reviews

---

🌟 4 Guest-Native Modes Built for Speed & Reliability

Mode	What It Scrapes	Key Data Extracted
🔍 search (Keyword Search)	Any brand, product, or lifestyle keywords (keywords, 300+ notes/keyword) with sort (popularity_descending, general, time_descending) & noteType filtering	Full untruncated post body (desc), hashtags, exact likes/collects/comments/shares, 24-hex creator IDs, uncompressed HD images (https://sns-img-qc.xhscdn.com/...) & watermark-free MP4 videos.
🔥 trending (Category Feeds)	13 official Xiaohongshu recommendation channels (Fashion, Beauty, Food, Travel, Home, Gaming, Pets, etc.)	Viral notes, full post descriptions, hashtags, likes/collects/comments/shares, buyer sentiment signals, uncompressed HD images & MP4 videos, optional author follower enrichment (includeAuthorProfile).
🔴 live (Live Streams)	7 official Xiaohongshu Live Stream categories with continuous pagination	Active live rooms (27 rooms/page), real-time total viewers (viewersTotalUv), concurrent viewers (viewersConcurrent), total views (roomPv), hotness score (hotValue), e-commerce shopping cart flag (hasGoods), 1080p .flv & .m3u8 HLS stream URLs, live chat messages (liveChatMessages), buyer intent prompts (buyerIntentKeywords), and host profiles.
📌 notes (Direct Note URLs)	Any list of Xiaohongshu post URLs (explore/<note_id> with or without ?xsec_token=...) or mobile share links (xhslink.com/...)	Full post text, hashtags, engagement metrics, buyer sentiment signals, hotlink-free HD photo galleries, and watermark-free MP4 video URLs.

---

📂 Available Category Channels (trending Mode — 13 Official Feeds)

• Trending / Explore: homefeed_recommend (全站推荐 / 热门精选)
• Fashion & Outfits: homefeed.fashion_v3 (穿搭 / 流行风尚)
• Beauty & Cosmetics: homefeed.cosmetics_v3 (彩妆 / 护肤美妆)
• Food & Gourmet: homefeed.food_v3 (美食 / 探店打卡)
• Pets & Animals: homefeed.pet (萌宠 / 治愈动物)
• Travel & Outdoors: homefeed.travel_v3 (旅行 / 露营出行)
• Home & Lifestyle: homefeed.household_product_v3 (家居 / 家装好物)
• Gaming & Anime: homefeed.gaming_v3 (游戏 / 二次元)
• Fitness & Wellness: homefeed.fitness_v3 (健身 / 运动减脂)
• Entertainment & Drama: homefeed.movie_and_tv_v3 (影视 / 娱乐追剧)
• Career & Workplace: homefeed.career_v3 (职场 / 技能成长)
• Relationships & Emotion: homefeed.love_v3 (情感 / 心理生活)
• Trending Videos Feed: homefeed.video_v3 (视频精选)

🔴 Available Live Stream Categories (live Mode — 7 Official Feeds)

• "0" — All Live Streams (全部直播): Highest-traffic live broadcasts across all verticals
• "1" — Gaming (游戏): Mobile, console, and PC gaming broadcasts
• "2" — Talent & Beauty (才艺颜值): Fashion styling, beauty routines, and talent shows
• "3" — Lifestyle (生活): Daily vlogs, cooking, and home life
• "4" — Crafts & Hobbies (手工文玩): Jewelry, crafts, art, and collectibles
• "5" — Tech & Finance (科技财经): Gadgets, automotive, and business discussions
• "6" — Sports & Outdoors (运动户外): Fitness workouts, camping, and outdoor gear

---

⚡ 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: Supports multi-page pagination across keyword searches (300+ unique notes per keyword), all 13 recommendation channels, and 7 live categories (100+ unique notes or live rooms per category with zero login).
• Bare Note URLs & Share Links Supported: Direct Note URLs (explore/<note_id>) work both with and without ?xsec_token=... parameters, alongside xhslink.com share links (for deep multi-page comment harvesting, see our RedNote Comments & Live Chat Scraper).
• Creator Portfolio Depth: Enable includeAuthorProfile to enrich note authors or live hosts with public profile stats (latest ~30 portfolio posts from public profile pages and exact totalLikesAndCollects without requiring cookies).
• Real-Time Live Stream URLs: Direct 1080p .flv and .m3u8 (HLS) video URLs (streamInfo) are real-time broadcast streams active while the host is live.

---

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

• 🛒 Live Commerce & E-Commerce Benchmarking: Monitor active shopping broadcasts (hasGoods: true), compare concurrent audience traffic (viewersConcurrent & hotValue), and capture real-time buyer 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.
• 🤝 MCNs & KOL / Influencer Recruiting: Identify breakout viral posts across 13 lifestyle categories and enrich author profiles (includeAuthorProfile / enrichLiveHostProfile) to discover rising creators and live shopping hosts.
• 📊 Consumer Social Listening & Trend Discovery: Track viral scores (viralScore), engagement rates (engagementRate), hashtags, and purchase sentiment signals (sentiment) across China's fastest-moving consumer verticals.

---

📥 Input Settings & Parameters

Setting	Type	Default	Description
mode	String	"trending"	Primary scraping mode: search (Keyword Search), trending (Category Feeds), live (Live Streams & E-Commerce), or notes (Direct Note URLs).
keywords	Array	[]	Search keywords (e.g. ["Lululemon", "护肤", "咖啡"]) to scrape in search mode (300+ notes per keyword).
sort	String	"popularity_descending"	Search sort order: popularity_descending (Most Popular), general (Relevance), or time_descending (Newest).
channels	Array	["homefeed_recommend"]	Select one or multiple official category channels to scrape in trending mode.
liveCategories	Array	["0"]	Select one or multiple live stream category IDs ("0" to "6") in live mode.
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).
noteUrls	Array	[]	Direct post URLs (explore/... with ?xsec_token=...) or xhslink.com mobile share links.
startUrls	Array	[]	Universal URL list: paste explore links (with ?xsec_token=...), live room URLs (xiaohongshu.com/livelist?...), or xhslink.com share links.
maxItems	Number	30	Maximum number of notes or live rooms to scrape across all targets (1 to 10,000).
noteType	String	"all"	Media format filter for trending mode: all, video_only, or image_only.
enrichDetails	Boolean	true	Fetches full post body, hashtags, HD images, video stream links, and purchase sentiment signals.
includeAuthorProfile	Boolean	false	Enriches each note's author with full profile metrics (follower count, verification badge, IP location).
resumptionToken	String	""	Base64 resumption token copied from a previous run's OUTPUT to resume pagination with zero duplicates.
proxyConfiguration	Object	Residential Proxy	Apify Residential Proxy configuration (useApifyProxy: true).

---

💻 Input Samples

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

{
  "mode": "search",
  "keywords": ["Lululemon", "露营装备"],
  "sort": "popularity_descending",
  "noteType": "all",
  "maxItems": 50,
  "enrichDetails": true
}

Sample 2: Multi-Category Trending Discovery (mode: "trending")

{
  "mode": "trending",
  "channels": [
    "homefeed.fashion_v3",
    "homefeed.cosmetics_v3"
  ],
  "maxItems": 50,
  "enrichDetails": true,
  "includeAuthorProfile": false
}

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

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

Sample 3: Direct Note URLs & Mobile Share Links (mode: "notes")

{
  "mode": "notes",
  "startUrls": [
    {
      "url": "https://www.xiaohongshu.com/explore/64be807d000000000800dabc?xsec_token=AB4829fa..."
    },
    {
      "url": "http://xhslink.com/a/abc123XYZ"
    }
  ],
  "maxItems": 10,
  "enrichDetails": true
}

---

📤 Output Samples

Sample 1: Enriched Note Item (mode: "trending" or "notes")

{
  "itemType": "note",
  "id": "6a7568cc00000000050328d9",
  "title": "Autumn Capsule Wardrobe: 5 Minimalist Outfits for Office & Daily Wear",
  "desc": "Sharing my favorite autumn minimalist styling guide! #AutumnOOTD #CapsuleWardrobe",
  "type": "video",
  "url": "https://www.xiaohongshu.com/explore/6a7568cc00000000050328d9?xsec_token=AB4829fa...&xsec_source=pc_feed",
  "isDetailEnriched": true,
  "author": {
    "id": "640000000000000000000007",
    "nickname": "Studio Style Notes",
    "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/640000000000000000000007.jpg",
    "profileUrl": "https://www.xiaohongshu.com/user/profile/640000000000000000000007",
    "redId": "studio_style_notes",
    "isVerified": false
  },
  "likedCount": 18450,
  "collectedCount": 12890,
  "commentCount": 420,
  "sharedCount": 3150,
  "viralScore": 62450.0,
  "engagementRate": 89.21,
  "imageCount": 1,
  "hasVideo": true,
  "coverUrl": "https://sns-img-qc.xhscdn.com/1040g008323luhj1vnk5g5qi11c5jv001abram18",
  "images": [
    "https://sns-img-qc.xhscdn.com/1040g008323luhj1vnk5g5qi11c5jv001abram18"
  ],
  "videoUrl": "https://sns-video-qc.xhscdn.com/stream/110/259/01e479a83bc.mp4",
  "videoDuration": 48,
  "ipLocation": "上海",
  "tags": ["AutumnOOTD", "CapsuleWardrobe"],
  "sentiment": {
    "hasPurchaseIntent": true,
    "hasInquiry": true,
    "hasPraise": true,
    "emojis": [],
    "intentKeywords": ["哪里买", "求链接", "多少钱"]
  },
  "scrapedAt": "2026-10-20T08:00:00.000Z"
}

Sample 2: Active Live Stream Room (mode: "live")

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

---

💰 Transparent Pay-Per-Event Pricing

This Actor operates under Apify's Pay-Per-Event (PPE) model. You only pay for valid delivered data with zero monthly subscription fees:

Event	Price	What You Get
Actor Run Startup (apify-actor-start)	$0.00001 ($0.00)	Micro-penny startup. Test runs execute risk-free.
Scraped Note / Live Room (note)	$0.0022 / item ($2.20 / 1k)	Charged only for valid, complete note or live room items delivered to your dataset (sliding volume discounts down to $1.50/1k).

---

💬 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 discovery and live stream 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.