# RedNote (Xiaohongshu / 小红书) Scraper: Posts, Trends & Creators (`unitbytes/xiaohongshu-scraper`) Actor ⚡Ultra Fast & Cheapest all-in-one Xiaohongshu (RedNote / 小红书 / XHS) scraper. Extract viral posts, search results, category trends, HD media & complete influencer intelligence in seconds. Zero cookies required. - **URL**: https://apify.com/unitbytes/xiaohongshu-scraper.md - **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community) - **Categories:** Social media, E-commerce, Lead generation - **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 note / post extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README

_{⚡ 1-Click Free Trial: Test live queries using Apify's $5 free monthly credit • No credit card required}

## RedNote (Xiaohongshu / 小红书) Scraper: All-in-One Posts, Search, Trends & Influencers The most comprehensive, lightning-fast, and cost-effective **Xiaohongshu (RedNote / 小红书 / RED)** scraper on Apify. Extract viral posts, search results, category trends, HD media links, and full creator intelligence—**100% autonomously with Zero Login & Zero Cookies Needed**. ***

⚡ UnitBytes · Xiaohongshu (RedNote) & Asian E-Commerce Ecosystem
🌟 RedNote All-in-One 📍 You are here Posts, Search, Trends & Creators	📕 RedNote Search & Trends Keyword & Category Feeds Fast discovery & HD media	💬 RedNote Comments Deep Discussion & Replies Nested replies (楼中楼) & sentiment	🇨🇳 1688 Factory Direct Domestic Wholesale & MOQ Factory pricing & SKU specs	🌐 Alibaba Wholesale Global B2B & Verified Suppliers Direct factory RFQs

*** ### 🌟 Why Choose This All-in-One Scraper? | Feature | This All-in-One Scraper | Legacy Single-Purpose Scrapers | Expensive Enterprise APIs | | :--- | :---: | :---: | :---: | | **All-in-One Modes** | **Search, Trends, Notes, Creators & Composite Discovery** | Search OR Creators Only | Fragmented Endpoints | | **Pricing Model** | **Pay-Per-Event (PPE)** | Expensive Monthly Rentals ($30–$80/mo) | High Minimum Retainers ($500+) | | **Startup Fee** | **$0.00001 (Virtually $0.00)** | Upfront Compute or Flat Fees | High Setup Fees | | **Cost per Note / Post** | **$0.0022 / note** | Pay compute time (often $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)** | User Must Supply Fragile Cookies | Complex Session Tokens | | **Superpower: Influencer Discovery** | **⚡ Auto-Audit Creators from Viral Posts (`deepCreatorAudit`)** | Not Supported | Manual Multi-Step Pipeline | | **HD Watermark-Free Media** | **100% Working Uncompressed Photos & MP4 Streams** | Expiring Thumbnails / Broken Links | None | | **Cold-Start Speed** | **<50ms (Pure HTTP / Zero-Browser)** | 10–30s Heavy Chromium Warmup | Variable REST Latency | | **Anti-Bot Reliability** | **Autonomous Device Handshake & Smart Session Pool** | Constant Verification Captchas | Frequent IP Bans | *** ### 🚀 Key Superpowers & Capabilities - **1. Viral Keyword & Hashtag Search:** - Search any keyword in Chinese, English, Pinyin, or hashtag format (e.g. `OOTD`, `护肤`, `穿搭`, `travel`, `home_decor`). - Sort by **Most Popular / Viral** (`popularity_descending`), **Newest First** (`time_descending`), or **Most Relevant** (`general`). - Filter by media format: **All Formats**, **Video Only**, or **Image Galleries Only**. - **2. Real-Time Category Trending Feeds:** - Extract live trending posts directly from Xiaohongshu’s official explore channels:\ `Explore / Recommend (全站热门)`, `Fashion & OOTD (穿搭)`, `Beauty & Cosmetics (美妆护肤)`, `Food & Gourmet (美食)`, `Travel (旅行)`, `Home & Lifestyle (家居)`, `Gaming (游戏)`, `Fitness (健身)`, `Entertainment (影视)`, `Career (职场)`, `Pets (萌宠)`, `Videos (精选视频)`. - **3. ⚡ Superpower: Deep Influencer Discovery & Audit (`deepCreatorAudit`):** - Enable with one click! Searches your target niche keywords $\rightarrow$ identifies viral posts $\rightarrow$ automatically extracts author profiles $\rightarrow$ scrapes their verified follower count, bio, and verification tier. The ultimate KOL recruitment shortcut. - **4. In-Depth Creator & KOL Intelligence:** - **Core Identifiers:** Nickname, Red ID, User ID, Profile URL, HD Avatar. - **Audience Metrics:** Follower Count, Following Count, Total Likes & Collects, Published Notes Count. - **Verification Badges:** Automatically categorized into **Official Brand** (企业号 / 品牌旗舰店), **Pro Creator** (知名博主 / 优质创作者), or **Individual** (个人创作者). - **Demographics:** Gender, IP Location (Country, Province, City), and Bio. - **5. Complete Published Note Portfolios:** - Paginates through any creator's published feed (`user_posted`) up to 1,000 posts per creator. - Computes weighted **Viral Score** and engagement rates. - **6. 100% Working HD Media (No Broken Links):** - Uncompressed full-resolution gallery photos (strips CDN compression parameters). - Direct watermark-free MP4 video stream download links. - **7. Zero Cookies Required:** - Operates completely autonomously using our pre-warmed, self-healing session vault. Never risk your personal Xiaohongshu account. *** ### 🎯 Popular Use Cases #### 1. Influencer Discovery & KOL Vetting Discover authentic Chinese creators for brand sponsorships, TikTok Shop affiliates, Amazon influencer marketing, or cross-border DTC campaigns. #### 2. Viral Trend & Content Strategy Track trending fashion styles, cosmetic ingredients, lifestyle aesthetics, and viral hashtags in real-time to guide your brand's social media content. #### 3. Competitor Brand Intelligence Monitor competitor brand accounts, track user reviews, analyze customer sentiment, and spot emerging consumer trends before they hit Western platforms. #### 4. Creative Inspiration & Moodboards Download high-resolution photography and watermark-free video clips for design research, product development, and moodboards. *** ### 📥 Input Settings & Parameters | Setting | Type | Default | Description | | :--- | :--- | :--- | :--- | | `startUrls` | Array | `["..."]` | Universal input: paste Xiaohongshu search URLs, trending category links, direct post links (`explore/...`), or creator profile links (`user/profile/...`). | | `keywords` | Array | `["OOTD"]` | Keywords or hashtags in Chinese, English, or Pinyin (e.g. `["护肤", "秋季穿搭"]`). | | `trendingChannel` | Select | `none` | Scrape real-time category trending feeds without keywords (`fashion`, `beauty`, `food`, `travel`, `home`, etc.). | | `sort` | Select | `popularity_descending` | `popularity_descending` (Most Viral), `time_descending` (Newest), or `general` (Relevance). | | `noteType` | Select | `all` | Filter by `all`, `video_only`, or `image_only`. | | `deepCreatorAudit` | Boolean | `false` | **SUPERPOWER:** Automatically audits creators behind discovered viral posts (scrapes followers, bio, verification). | | `creatorUrls` | Array | `[]` | Direct creator profile URLs or mobile share links (`xhslink.com/...`). | | `userIds` | Array | `[]` | Direct 24-character hexadecimal user IDs (`5b331070e8cd614138e4a9e5`). | | `redIds` | Array | `[]` | Xiaohongshu Red IDs / handles (e.g. `88888888`, `style_daily`). | | `maxItems` | Integer | `30` | Maximum total posts and profiles to collect across the run. | | `maxCreators` | Integer | `10` | Maximum creators to audit in Creator or Composite mode (1 to 100). | | `maxNotesPerCreator` | Integer | `30` | Maximum notes to extract per creator (set to 0 for profile stats only). | | `scrapePortfolio` | Boolean | `true` | When scraping creators, extract their full portfolio of published posts. | | `enrichNoteDetails` | Boolean | `true` | Fetch full note description, HD media galleries, and watermark-free video download links. | | `resumptionToken` | String | `""` | Enterprise resumption token from previous run to continue pagination with 0 duplicates. | | `proxyConfiguration` | Object | `Residential (HK)` | Built-in Apify Residential proxy in Hong Kong (strongly recommended). | *** ### 💻 Input Samples #### Sample 1: Default Search (Viral Posts + HD Media) ```json { "keywords": ["OOTD", "秋季穿搭"], "sort": "popularity_descending", "maxItems": 20, "enrichNoteDetails": true } ``` #### Sample 2: ⚡ Influencer Discovery (Search + Creator Audit) ```json { "keywords": ["护肤"], "deepCreatorAudit": true, "maxItems": 20, "maxCreators": 5, "maxNotesPerCreator": 2 } ``` #### Sample 3: Explore Real-Time Trending Feeds ```json { "trendingChannel": "homefeed.fashion_v3", "maxItems": 30, "enrichNoteDetails": true } ``` #### Sample 4: Creator Profile Intelligence & Portfolio ```json { "creatorUrls": [ { "url": "https://www.xiaohongshu.com/user/profile/5b331070e8cd614138e4a9e5" } ], "maxNotesPerCreator": 15, "scrapePortfolio": true } ``` *** ### 📤 Output Formats & Clean Dataset Views The Actor formats data cleanly and provides **3 pre-configured Apify Dataset Views**: - **Unified Overview (`overview`)**: Key metrics combining posts, creators, and engagement. - **Notes & Posts (`notes`)**: Filtered view for post titles, HD media, viral scores, and tags. - **Creators & Influencers (`creators`)**: Filtered view for KOL follower counts, verification badges, and bios. #### Sample Note Output (`itemType: "note"`) ```json { "itemType": "note", "id": "64a7f30200000000160269ae", "title": "早秋高级感通勤穿搭 | 5套胶囊衣橱指南", "desc": "秋天第一波气质穿搭来啦！衬衫搭配西装裤，高级感拉满...", "type": "normal", "url": "https://www.xiaohongshu.com/explore/64a7f30200000000160269ae", "coverUrl": "https://sns-webpic-qc.xhscdn.com/2026/10/cover.jpg", "likedCount": 35200, "collectedCount": 21800, "commentCount": 1420, "sharedCount": 2890, "viralScore": 94000.0, "engagementRate": 74.18, "hasVideo": false, "images": [ "https://sns-webpic-qc.xhscdn.com/2026/10/img1.jpg", "https://sns-webpic-qc.xhscdn.com/2026/10/img2.jpg" ], "creator": { "id": "5a609866e8ac2b2fc9c2aa72", "nickname": "什么周周", "redId": "zhouzhoujh", "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/1000/5a609866e8ac2b2fc9c2aa72.jpg" }, "tags": ["OOTD", "秋季穿搭", "通勤穿搭"], "scrapedAt": "2026-10-06T21:00:00.000Z" } ``` #### Sample Creator Intelligence Output (`itemType: "creator_profile"`) ```json { "itemType": "creator_profile", "id": "5a609866e8ac2b2fc9c2aa72", "nickname": "什么周周", "redId": "zhouzhoujh", "bio": "分享日常穿搭与生活美学商务合作私信", "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/1000/5a609866e8ac2b2fc9c2aa72.jpg", "gender": "female", "ipLocation": "上海", "verification": { "badge": "Pro Creator", "isVerified": true, "desc": "小红书知名时尚博主" }, "followerCount": 285000, "followingCount": 194, "totalLikesAndCollects": 1820000, "notesCount": 412, "profileUrl": "https://www.xiaohongshu.com/user/profile/5a609866e8ac2b2fc9c2aa72", "scrapedAt": "2026-10-06T21: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 search result, trending note, or portfolio post extracted with HD media. | | `profile` | **$0.005** | Charged per creator profile successfully enriched with followers, bio & badges. | #### Pricing Examples: - **50 Viral Search Posts:**\ `$0.00001 (start) + (50 * $0.0022) = $0.11 total` - **100 Posts + Influencer Discovery (10 Creators Audited):**\ `$0.00001 (start) + (100 * $0.0022) + (10 * $0.005) = $0.27 total` - **5 Creator Portfolios (20 Notes Each = 100 Notes + 5 Profiles):**\ `$0.00001 (start) + (100 * $0.0022) + (5 * $0.005) = $0.245 total` *** ### 🔒 Security & Quality Standards - **Zero-Storage Cookie Leakage:** The Actor does not accept or store user session cookies or credentials. - **Pure-HTTP 256MB RAM Tier:** Never launches heavy headless browsers. Extremely fast, lightweight, and low cost. - **The Exit-Code 0 Rule:** Cleanly handles user errors, non-existent entities, and challenge fallbacks with structured error items and exit code 0. - **Enterprise Resumption:** Base64 resumption tokens ensure seamless multi-batch pagination with zero duplicate items across runs. *** ### 🔗 The UnitBytes Xiaohongshu & Sourcing Ecosystem Looking for specialized scrapers tailored to specific stages of your workflow? Explore our full production ecosystem: - 🌟 **[RedNote (Xiaohongshu) All-in-One Scraper](https://apify.com/unitbytes/xiaohongshu-scraper?fpr=939u3w\&fp_sid=ecosystem)** (📍 You are here): Unified scraping for search, category trends, creator analytics, and auto-influencer audits. - 📕 **[RedNote Search & Trends Scraper](https://apify.com/unitbytes/xiaohongshu-rednote-trend-scraper?fpr=939u3w\&fp_sid=ecosystem)**: Dedicated high-speed keyword search, explore feeds, and watermark-free media downloads. - 💬 **[RedNote Dedicated Comments Scraper](https://apify.com/unitbytes/xiaohongshu-rednote-comments-scraper?fpr=939u3w\&fp_sid=ecosystem)**: Deep comment extraction, nested sub-replies (楼中楼), and customer sentiment scoring. - 🇨🇳 **[1688 Factory Direct Scraper](https://apify.com/unitbytes/1688-scraper?fpr=939u3w\&fp_sid=ecosystem)**: Real-time Chinese factory pricing, SKU matrices, and MOQ sourcing specifications. - 🌐 **[Alibaba Wholesale Scraper](https://apify.com/unitbytes/alibaba-scraper?fpr=939u3w\&fp_sid=ecosystem)**: Global B2B marketplace search and verified supplier intelligence. - 🐟 **[GooFish (Idle Fish / 闲鱼) Product Scraper](https://apify.com/unitbytes/goofish-xianyu-search-scraper?fpr=939u3w\&fp_sid=ecosystem)**: C2C secondary market products, secondhand electronics, and arbitrage price tracking. - ⭐ **[GooFish Seller Audit Scraper](https://apify.com/unitbytes/goofish-xianyu-seller-scraper?fpr=939u3w\&fp_sid=ecosystem)**: C2C merchant reputation, historical sales, and Zhima credit checks. *** ### 💬 Enterprise Support & Custom Pipelines Need dedicated SLAs, custom data schemas, high-throughput pipelines, or private actor deployments? - 📧 **Direct Email**: - 🌐 **Enterprise Platform**: - 💡 **Data Engine Specs & Live Docs**: *** ### ⚖️ Disclaimer This Actor is an independent, third-party software solution developed and maintained by UnitBytes. It is **not** affiliated, associated, authorized, endorsed by, or in any way officially connected with Xiaohongshu (RED / 小红书 / Xingin Information Technology Co., Ltd.) or any of its subsidiaries or affiliates. - **Public Data Only:** This tool extracts only publicly accessible data available on the web and does not circumvent any access controls, private authentication walls, or confidential user permissions. - **Compliance & Fair Use:** Users are solely responsible for ensuring that their data extraction and processing activities adhere to applicable local, national, and international laws, intellectual property rights, data privacy regulations (such as GDPR, CCPA, and PIPL), and target terms of service. - **Limitation of Liability:** The software is provided "as is" without warranties of any kind. The authors and maintainers shall not be held liable for any claims, damages, account penalties, or legal liabilities arising from the use or misuse of this tool or the collected data. # Actor input Schema ## `startUrls` (type: `array`): Universal input: paste Xiaohongshu/RedNote search URLs ('search_result?keyword=...'), trending feeds, direct post links ('explore/...'), or creator profile links ('user/profile/...'). ## `keywords` (type: `array`): Keywords in Chinese, English, Pinyin, or hashtags (e.g. 'OOTD', '护肤', 'skincare', '秋季穿搭', '美食'). ## `trendingChannel` (type: `string`): Scrape official real-time trending feeds by category without requiring login or user credentials. ## `sort` (type: `string`): Ranking order for note discovery. ## `noteType` (type: `string`): Filter by media format. ## `deepCreatorAudit` (type: `boolean`): SUPERPOWER: Automatically audits the creators behind top viral posts! Searches your keyword or category, extracts author profile links, and scrapes their follower counts, verification badges, bio, and engagement metrics. ## `creatorUrls` (type: `array`): Direct Xiaohongshu creator profile URLs (e.g. 'https://www.xiaohongshu.com/user/profile/5b331070e8cd614138e4a9e5?xsec_token=...') or mobile share links ('xhslink.com/...'). ## `userIds` (type: `array`): Direct 24-character hexadecimal Xiaohongshu user IDs (e.g. '5b331070e8cd614138e4a9e5'). Extracts full creator profile intelligence (stats, bio, verification). ## `redIds` (type: `array`): Xiaohongshu Red IDs / handles (e.g. '88888888', 'fashion_daily'). Matched and verified against creator profiles. ## `maxCreators` (type: `integer`): Maximum number of creators to enrich across all targets or in composite discovery (1 to 100). ## `maxNotesPerCreator` (type: `integer`): Maximum number of notes to scrape per creator (0 to 1,000). Set to 0 to extract Creator Profile Intelligence only. ## `scrapePortfolio` (type: `boolean`): When enabled, paginates through the creator's published notes to extract complete portfolio metrics and engagement. ## `enrichNoteDetails` (type: `boolean`): When enabled, fetches full post body, hashtags, uncompressed HD gallery images, and watermark-free video download link. ## `maxItems` (type: `integer`): Maximum total items (posts and profiles) to scrape across the run. ## `resumptionToken` (type: `string`): Optional enterprise resumption token copied from a previous run's pagination metadata to resume with exact session continuity. ## `proxyConfiguration` (type: `object`): Leave as is to use the built-in Apify Residential proxy in Hong Kong (strictly recommended for Xiaohongshu anti-bot). You can also enter your own residential proxy URLs. ## Actor input object example ```json { "startUrls": [], "keywords": [ "OOTD" ], "trendingChannel": "none", "sort": "popularity_descending", "noteType": "all", "deepCreatorAudit": false, "maxCreators": 10, "maxNotesPerCreator": 30, "scrapePortfolio": true, "enrichNoteDetails": true, "maxItems": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "HK" } } ``` # Actor output Schema ## `creatorDataset` (type: `string`): Enriched creator profile intelligence, verification badges, engagement metrics, and complete note portfolio items. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [], "keywords": [ "OOTD" ], "maxCreators": 10, "maxNotesPerCreator": 30, "maxItems": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "HK" } }; // Run the Actor and wait for it to finish const run = await client.actor("unitbytes/xiaohongshu-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [], "keywords": ["OOTD"], "maxCreators": 10, "maxNotesPerCreator": 30, "maxItems": 30, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "HK", }, } # Run the Actor and wait for it to finish run = client.actor("unitbytes/xiaohongshu-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [], "keywords": [ "OOTD" ], "maxCreators": 10, "maxNotesPerCreator": 30, "maxItems": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "HK" } }' | apify call unitbytes/xiaohongshu-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/xiaohongshu-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/NzBoPbZgu2qYHvkyZ/builds/OQp0Jc5IAhCf7dlgH/openapi.json