Xiaohongshu Profile Scraper: RedNote KOL & User API ($3.50/1k)

RedNote (Xiaohongshu / 小红书) Creator, KOL Leads & Influencer Profile Scraper

The fastest, most accurate, and cost-effective Xiaohongshu (RedNote / 小红书 / RED) Creator & KOL Leads Scraper on Apify. Automatically discover active KOLs & live stream hosts by search keywords, across 13 lifestyle categories, or across active live rooms, or audit specific creator profiles for follower counts, exact total likes & collects, verification badges, audience IP locations, bios, and recent published note portfolios—100% autonomously with Zero Login & Zero Cookies Needed.

[!IMPORTANT] 🆕 V2 Engine Upgrade — Keyword KOL Discovery & Bare Note Author Resolution:

• Keyword-Driven KOL Lead Generation (keywords): Enter niche or brand keywords (e.g. ["Lululemon", "护肤测评"]) in creatorLeads mode to automatically discover matching creators and enrich their full KOL profiles.
• Bare Note URL Author Resolution: Paste plain xiaohongshu.com/explore/<id> or rednote.com/discovery/item/<id> URLs (no ?xsec_token needed), user/profile/<id> URLs, xhslink.com/... share links, or 24-character userIds.

---

⚡ UnitBytes · Xiaohongshu (RedNote) 5-Flavor Scraper Suite & Sourcing Ecosystem
🌟 RedNote All-in-One 7-in-1 Flagship Suite Search, Comments, Trends, Live & KOLs	👤 RedNote Creators 📍 You are here KOL leads, badges & portfolios	🔴 RedNote Live & Commerce 1080p FLV/HLS & Live Chat E-commerce rooms & buyer prompts	📕 RedNote Search & Posts Keyword Search & 13 Feeds 300+ notes/kw, bare URLs & HD media	💬 RedNote Comments Comments & Live Chat Nested replies (楼中楼) & sentiment

---

🌟 2 Powerful Creator Intelligence Modes

Feature / Mode	🎯 creatorLeads (KOL Lead Discovery)	👤 creators (Direct Profile Audit)
How It Works	Automatically sweeps your target Search Keywords (keywords), 13 Category Channels (channels), and Active Live Streams (includeLiveHosts) to discover trending creators & live shopping hosts, then enriches their full profiles.	Audits specific creators from creatorUrls, 24-character userIds, mobile share links (xhslink.com/...), or note URLs (explore/... with or without ?xsec_token=...).
Input Needed	Zero URLs Needed — Enter target keywords (e.g. ["Lululemon", "护肤"]) or pick categories (Fashion, Beauty, Food, etc.)	Profile URLs, 24-char userIds, or Note URLs
Profile Intelligence	Followers (followerCount & followerCountFormatted), Following, Exact Total Likes & Collects (totalLikesAndCollects, likedCount, collectedCount), Notes Count, Verification Badge, IP Location, Gender, Bio	Followers (followerCount & followerCountFormatted), Following, Exact Total Likes & Collects (totalLikesAndCollects, likedCount, collectedCount), Notes Count, Verification Badge, IP Location, Gender, Bio
Portfolio Notes	Optional recent published notes (scrapePortfolio: true, up to ~30 recent public portfolio notes per creator)	Optional recent published notes (scrapePortfolio: true, up to ~30 recent public portfolio notes per creator)

---

🚀 Key Capabilities

• 1. Automated KOL & Live Host Lead Generation (mode: "creatorLeads"):
  • Discover rising influencers and active e-commerce live streamers by Search Keywords (keywords) or across Fashion (homefeed.fashion_v3), Beauty (homefeed.cosmetics_v3), Food (homefeed.food_v3), Travel (homefeed.travel_v3), Home (homefeed.household_product_v3), Tech, Fitness, and Pets without needing a pre-existing list of profile links.
• 2. Multi-Format Creator Resolution (mode: "creators"):
  • Paste direct profile links (https://www.xiaohongshu.com/user/profile/...), mobile share shortlinks (xhslink.com/...), raw 24-character hexadecimal userIds, or direct note URLs (explore/<id> with or without ?xsec_token=... — automatically resolves the note's author profile).
• 3. Comprehensive KOL & Brand Profile Intelligence:
  • Core Identifiers: Nickname, Red ID (redId), User ID, Profile URL, and HD Avatar URL.
  • Audience & Reach Metrics: totalLikesAndCollects, likedCount, and collectedCount provide exact integer totals, while public guest profiles return both numeric followerCount and followerCountFormatted (10K+) / followerCountDisplay (1万+), plus followingCount and notesCount.
  • Verification Badges: Classifies accounts into Official Brand (企业号 / 品牌旗舰店), Pro Creator (知名博主 / 优质创作者), or Individual (个人创作者).
  • Demographics & Collaboration Signals: Gender, IP Location (ipLocation and structured locationDetails), and full Creator Bio (bio) containing public brand collaboration details and MCN affiliations.
• 4. Recent Published Note Portfolios (scrapePortfolio):
  • Extracts the creator's latest ~30 published notes from public profile pages, complete with Viral Score (viralScore), Engagement Rate (engagementRate), and optional HD media enrichment (enrichNoteDetails).

---

⚡ 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: In creatorLeads mode, supports multi-page discovery by keywords, across all 13 recommendation channels, and across 7 live categories (100+ unique notes or live rooms per query with zero login) to harvest a rich pool of active KOLs and live hosts.
• Creator Portfolio Depth: Public profiles return the creator's latest ~30 portfolio posts from Page 1 of their public profile without requiring user cookies (paginating older historical posts beyond ~30 requires an authenticated Xiaohongshu account). Large follower counts above 10,000 are normalized from Xiaohongshu's public 万 display (e.g. followerCountDisplay: "1.2万" → followerCount: 12000), while totalLikesAndCollects provides exact sums when available.
• Bare Note & Creator Resolution: Creator userIds accept bare 24-character hex user IDs directly, and note URLs (explore/<note_id>) resolve creator profiles with or without ?xsec_token=....
• Real-Time Live Stream URLs: Live host discovery in creatorLeads mode taps into real-time broadcast feeds on Xiaohongshu Live while hosts are actively streaming.

---

🎯 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 evaluate public creator bios for brand fit (bio).
• 🛒 Live Commerce & E-Commerce Benchmarking: Identify active live shopping hosts (includeLiveHosts: true) and audit their historical note engagement (totalLikesAndCollects, likedCount, collectedCount) before booking sponsorships.
• 🎙️ AI / ASR Multimodal Video & Stream Analysis: Extract recent creator portfolio videos (scrapePortfolio: true) and feed watermark-free MP4 URLs into multimodal AI models to evaluate creator presentation style and content quality.
• 📊 Consumer Social Listening & Brand Due Diligence: Track brand account growth, regional creator distributions (locationDetails), and topic performance across recent portfolio posts (portfolio_note).

---

📥 Input Settings & Parameters

Setting	Type	Default	Description
mode	Select	"creatorLeads"	creatorLeads (Auto-discover KOLs by keywords, category feeds & live streams) or creators (Scrape specific creator URLs / user IDs).
keywords	Array	[]	Search keywords (e.g. ["Lululemon", "美妆测评"]) used to discover niche KOLs & creators in creatorLeads mode.
channels	Array	["homefeed_recommend", "homefeed.fashion_v3", "homefeed.cosmetics_v3"]	Category channels used to discover active KOLs when mode="creatorLeads".
includeLiveHosts	Boolean	true	When mode="creatorLeads", also discovers active live stream hosts from Xiaohongshu Live.
liveCategories	Array	["0", "2"]	Live stream categories to scan for hosts when includeLiveHosts=true.
creatorUrls	Array	[]	Xiaohongshu creator profile URLs (user/profile/<id>), mobile share links (xhslink.com/...), or note URLs (explore/<id> with or without ?xsec_token=...).
userIds	Array	[]	Direct 24-character hexadecimal Xiaohongshu user IDs (e.g. 58351cb382ec392d5f015f86).
maxCreators	Integer	10	Maximum number of unique creators to scrape in a single run (1 to 100).
scrapePortfolio	Boolean	true	Extract each creator's recent published notes (~30 latest public notes). In creatorLeads mode, defaults to fast profile-only extraction unless maxNotesPerCreator is also customized.
maxNotesPerCreator	Integer	15	Maximum number of recent portfolio notes to extract per creator (1 to 35; up to ~30 recent public portfolio notes).
enrichNoteDetails	Boolean	true	Fetch full note body text, hashtags, uncompressed HD gallery photos, and watermark-free MP4 video links.
resumptionToken	String	""	Base64 resumption token from a previous run to resume without duplicates.
proxyConfiguration	Object	Residential (HK)	Built-in Apify Residential proxy in Hong Kong (recommended).

---

💻 Input Samples

Sample 1: Automated KOL & Live Host Lead Discovery (mode: "creatorLeads")

{
  "mode": "creatorLeads",
  "keywords": ["Lululemon", "护肤测评"],
  "channels": [
    "homefeed.fashion_v3",
    "homefeed.cosmetics_v3"
  ],
  "includeLiveHosts": true,
  "liveCategories": ["0", "2"],
  "maxCreators": 25,
  "scrapePortfolio": false
}

Sample 2: Specific Creator Profile + Recent Portfolio Audit (mode: "creators")

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

---

📤 Output Formats & Dataset Views

The Actor outputs structured JSON items and provides 3 pre-configured Dataset Views:

• Creators & Influencers (creators): Dedicated table showing Nickname, Red ID, Followers, Following, Total Likes & Collects, Verification Badge, Gender, IP Location, Bio, and Profile Link.
• Portfolio Notes & Posts (notes): Table of published notes for audited creators.
• Unified Overview (overview): Combined view of creator profiles and their published portfolio notes.

Sample 1: Creator Profile 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"
}

Sample 2: Creator Portfolio Note Output (itemType: "portfolio_note")

{
  "itemType": "portfolio_note",
  "id": "64a7f30200000000160269ae",
  "title": "早秋高级感通勤穿搭 | 5套胶囊衣橱指南",
  "desc": "秋天第一波气质穿搭来啦！衬衫搭配西装裤，高级感拉满 #OOTD #秋季穿搭",
  "type": "normal",
  "format": "image",
  "url": "https://www.xiaohongshu.com/explore/64a7f30200000000160269ae?xsec_token=AB4829fa...&xsec_source=pc_user",
  "coverUrl": "https://sns-img-qc.xhscdn.com/1040g008323luhj1vnk5g5qi11c5jv001abram18",
  "images": [
    "https://sns-img-qc.xhscdn.com/1040g008323luhj1vnk5g5qi11c5jv001abram18"
  ],
  "imageCount": 1,
  "likedCount": 3520,
  "collectedCount": 2180,
  "commentCount": 142,
  "sharedCount": 289,
  "viralScore": 9462.0,
  "engagementRate": 74.18,
  "hasVideo": false,
  "publishedAt": "2026-10-15T10:30:00+00:00",
  "creator": {
    "id": "5a0000000000000000000001",
    "nickname": "林小夏穿搭",
    "redId": "linxiaoxia_ootd",
    "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/1000/5a0000000000000000000001.jpg",
    "ipLocation": "上海",
    "verification": "Pro Creator"
  },
  "author": {
    "id": "5a0000000000000000000001",
    "nickname": "林小夏穿搭",
    "redId": "linxiaoxia_ootd",
    "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/1000/5a0000000000000000000001.jpg",
    "ipLocation": "上海",
    "verification": "Pro Creator"
  },
  "tags": ["OOTD", "秋季穿搭"],
  "sentiment": {
    "hasPurchaseIntent": false,
    "hasInquiry": false,
    "hasPraise": true,
    "emojis": [],
    "intentKeywords": []
  },
  "scrapedAt": "2026-10-20T08:00:00.000Z"
}

---

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

Event	Price (USD)	Description
apify-actor-start	$0.00001	Virtually $0.00 startup barrier.
profile	$0.0035 – $0.0050	Charged per creator profile extracted with followers, bio & verification badges.
note	$0.0015 – $0.0022	Charged per published portfolio note extracted with HD media.

---

💬 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 creator profile and portfolio 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-rednote-profile-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-rednote-profile-scraper",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}