Skip to content

Repository files navigation

Xiaohongshu (RedNote) Scraper API by UnitBytes

Try it for Free
⚡ 1-Click Free Trial: Test live queries using Apify's $5 free monthly credit • No credit card required

Xiaohongshu (RedNote / 小红书) Scraper: Viral Trends, Posts, HD Media & Buyer Sentiment

The most powerful, reliable, and cost-effective Xiaohongshu (RedNote / 小红书 / RED) scraper on Apify. Extract viral trend discovery feeds, post content, influencer (KOL) engagement, consumer buying sentiment signals, and watermark-free original HD photos & videos—100% autonomously with Zero Login & Zero Cookies Needed.

Note

Zero Login & Zero Cookies Required: Unlike other scrapers that require you to copy fragile session cookies from personal accounts, this Actor uses autonomous device handshakes. No accounts are at risk, and sessions never expire mid-scrape.


⚡ 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
📕 Xiaohongshu Trends
📍 You are here
Viral Posts & Buyer Intent
🐟 Goofish Products
C2C Resale & Arbitrage
Zero-login search engine
⭐ Goofish Sellers
Merchant Due Diligence
Zhima credit & reviews

⚡ Pre-Configured 1-Click Tasks & Common Use Cases

Skip manual parameter setup. Launch these ready-to-use task presets directly in 1 click or inspect full configuration details:

Trend Preset / Target Vertical Description & Target Query ⚡ Direct Run / Input Page 📋 Store Task Details
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 📖 View Task Page
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 📖 View Task Page
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 📖 View Task Page
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 📖 View Task Page
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 📖 View Task Page
Xiaohongshu Home Decor Scraper (家居家装) Collect minimalist interior design, cozy bedroom decor, apartment organization ideas, and modern lifestyle tips from Xiaohongshu RedNote. ⚡ Run Task Preset 📖 View Task Page
Xiaohongshu Fitness & Wellness Tracker (健身运动) Track workout routines, healthy clean eating meals, yoga flows, and weight loss transformations on Xiaohongshu RedNote. ⚡ Run Task Preset 📖 View Task Page
Xiaohongshu Gaming & Anime Scraper (游戏动漫) Scrape gaming guides, esports highlights, anime cosplay, and mobile game updates on Xiaohongshu with high viral scores. ⚡ Run Task Preset 📖 View Task Page
Xiaohongshu Consumer Sentiment & Feedback (真实测评) Extract authentic customer feedback, purchase intent keywords ('where to buy', 'price inquiry'), praise, and complaints on Xiaohongshu for market research. ⚡ Run Task Preset 📖 View Task Page
Xiaohongshu Influencer & KOL Tracker (博主发现) Identify top creators, KOLs, and KOCs across niches on Xiaohongshu RedNote. Scrape author profile URLs, RED IDs, engagement rates, and viral scores for influencer marketing. ⚡ Run Task Preset 📖 View Task Page

🌟 Why Choose This Scraper Over Other Scrapers?

Feature This Scraper Other Scrapers External Data APIs
Pricing Model Pay-Per-Result (PPE) Expensive Monthly Subscriptions High Per-Request Rates
Cost per 1,000 Posts ~$2.00 / 1k $20.00 – $40.00 / 1k $30.00 – $50.00 / 1k
Account / Cookie Requirement None (100% Zero Cookies Needed) User Must Supply Personal Cookies API Keys Required
Multi-Page Discovery Continuous Deep Pagination (Thousands of Posts) Stops After 1 Page (~30 Notes) Rate Limited
Client-Side Discarding Zero Discarding (100% Data Delivery) Filters & Drops Paid Results Varies
Consumer Buying Sentiment Included (Purchase Intent Signals) Not Available Not Available
Media Quality Hotlink-Free HD Photos & MP4 Broken / Inaccessible Links Compressed Thumbnails
Official Category Feeds 13 Built-in Lifestyle Channels Keyword Search Only Limited Endpoints
Mobile Share Link Resolution Automatic (xhslink.com) Manual Conversion Required Varies
Anti-Bot Reliability Autonomous Device Handshake Frequent IP & Session Bans Cloudflare Captchas

🚀 Key Benefits & Features

  • Zero Cookies & Zero Login Required: Start scraping right away without risking personal accounts, dealing with QR code verifications, or copying expiring session tokens.
  • Pay Only For Delivered Results: Powered by Apify Pay-Per-Event pricing. You only pay for the actual records delivered to your dataset ($0.002 per note).
  • Continuous Multi-Page Discovery: Effortlessly paginate across multiple pages (Page 1, 2, 3... up to thousands of notes) to collect complete datasets up to your exact maxItems.
  • 100% Delivered Data (Zero Client-Side Discarding): All server-returned notes matching your upstream filters are delivered directly to your dataset—no wasted compute or proxy bandwidth.
  • Hotlink-Free Original HD Media: Extracts uncompressed full-resolution gallery photos and direct MP4 video stream links. All image and cover URLs are hotlink-free and accessible directly from any web browser, dashboard, or external application without access denied errors.
  • E-Commerce Buyer Sentiment Intelligence: Built-in NLP algorithms automatically detect purchase intent flags ("where to buy", "link please", "how much", "dupe for"), product inquiries, and positive consumer praise.
  • Complete Engagement & Influencer Metrics: Captures real-time likes, bookmarks (collections), comment counts, shares, author profiles, and calculates a standardized Viral Score.
  • Search URLs & Mobile Share Links: Paste raw Xiaohongshu search URLs, desktop explore links, mobile share links (xhslink.com), or bare 24-character post IDs.

🎯 Popular Use Cases

1. E-Commerce & Dropshipping Product Discovery

Spot emerging viral fashion items, beauty routines, lifestyle gadgets, and home aesthetics weeks before they appear on TikTok, Amazon, or Western markets. Identify winning products by filtering posts with high purchase intent signals.

2. Influencer (KOL) & Brand Analytics

Monitor brand mentions, competitor product launches, influencer marketing ROI, and organic customer reactions across China's largest trendsetting social commerce network.

3. Market Research & Consumer Review Mining

Mine thousands of authentic consumer reviews, unboxings, and product comparisons to analyze sentiment, price perception, and feature preferences.

4. Creative Inspiration & Social Video Downloader

Download high-definition, watermark-free videos and gallery photos from trending posts across 13 lifestyle categories for creative analysis and moodboards.


📥 Input Settings & Parameters

Setting Type Default Description
startUrls Array [] Paste Xiaohongshu search URLs (e.g. https://www.xiaohongshu.com/search_result?keyword=OOTD), category links, or direct post URLs.
keywords Array ["OOTD"] Target keywords or hashtags in Chinese, English, or Pinyin (e.g. ["OOTD", "穿搭", "skincare", "咖啡"]).
trendingChannel String "none" Select an official real-time category channel dropdown (e.g. Trending / Explore, Fashion, Beauty, Food, Pets).
noteUrls Array [] Direct post URLs (including ?xsec_token=...) or xhslink.com mobile share links.
resumptionToken String "" Enterprise Base64 resumption token copied from a previous run's OUTPUT to resume pagination with exact session continuity and zero duplicates.
maxItems Number 30 Maximum number of notes to scrape across all targets (1 to 10,000).
sort String "popularity_descending" Ranking order: popularity_descending (viral/most popular), time_descending (newest first), or general (comprehensive).
noteType String "all" Upstream media format filter: all, video_only, or image_only.
enrichDetails Boolean true When enabled, fetches full post body, hashtags, HD images, video stream links, and purchase sentiment signals across 10 parallel workers.
proxyConfiguration Object Residential Proxy Apify Residential Proxy is recommended for stable, uninterrupted connection.

📂 Available Category Channels (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 (视频精选)

💻 Input Samples

Sample 1: Search URL or Keywords (Trending Products & Viral Content)

{
  "startUrls": [
    { "url": "https://www.xiaohongshu.com/search_result?keyword=vintage&sort=popularity_descending" }
  ],
  "keywords": ["OOTD", "Cleanfit"],
  "maxItems": 50,
  "sort": "popularity_descending",
  "noteType": "all",
  "enrichDetails": true
}

Sample 2: Category Trending Discovery (Market Research Without Keywords)

{
  "trendingChannel": "homefeed.fashion_v3",
  "maxItems": 50,
  "enrichDetails": true
}

Sample 3: Video-Only Viral Content Extractor

{
  "keywords": ["美食教程"],
  "noteType": "video_only",
  "sort": "popularity_descending",
  "maxItems": 100,
  "enrichDetails": false
}

Sample 4: Specific Post URLs & Deep Content Extraction

Scrape specific Xiaohongshu posts by URL or mobile share link (xhslink.com) to extract full text, author profiles, watermark-free direct MP4 video URLs, and hotlink-free HD galleries:

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

Sample 5: Enterprise Resumption & Continuous Scraping

Resume an interrupted run or continue deep pagination without duplicate notes (copy your resumptionToken from the OUTPUT tab in your previous run's Key-Value Store):

{
  "resumptionToken": "REPLACE_WITH_YOUR_RESUMPTION_TOKEN",
  "maxItems": 100
}

📤 Output Sample

Each item in your dataset is delivered with enriched structured data:

{
  "id": "6a7568cc00000000050328d9",
  "title": "Autumn Capsule Wardrobe: 5 Minimalist Outfits for Office & Daily Wear",
  "desc": "Sharing my favorite autumn minimalist styling guide! Coat from vintage thrift store, trousers matched with loafers. #AutumnOOTD #CapsuleWardrobe #MinimalistStyle #OfficeFashion",
  "type": "video",
  "url": "https://www.xiaohongshu.com/explore/6a7568cc00000000050328d9?xsec_token=AB4829fa...&xsec_source=pc_feed",
  "author": {
    "id": "647b64a400000000120349b8",
    "nickname": "Elena Daily Style",
    "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/647b64a400000000120349b8.jpg",
    "profileUrl": "https://www.xiaohongshu.com/user/profile/647b64a400000000120349b8",
    "redId": "elena_fashion",
    "bio": "Fashion & Lifestyle Creator in Shanghai | Daily Outfit Inspo",
    "isVerified": false
  },
  "likedCount": 18450,
  "collectedCount": 12890,
  "commentCount": 420,
  "sharedCount": 3150,
  "canShare": true,
  "viralScore": 62450.0,
  "engagementRate": 89.21,
  "imageCount": 2,
  "hasVideo": true,
  "isLivePhoto": false,
  "coverUrl": "https://sns-img-qc.xhscdn.com/1040g008323luhj1vnk5g5qi11c5jv001abram18",
  "coverDimensions": {
    "width": 1080,
    "height": 1440
  },
  "images": [
    "https://sns-img-qc.xhscdn.com/1040g008323luhj1vnk5g5qi11c5jv001abram18",
    "https://sns-img-qc.xhscdn.com/1040g2sg323jg6lprgmig5n7igt3h9u3s8t45lfo"
  ],
  "videoUrl": "https://sns-video-qc.xhscdn.com/stream/110/259/01e479a83bc.mp4",
  "videoDuration": 48,
  "ipLocation": "上海",
  "tags": [
    "AutumnOOTD",
    "CapsuleWardrobe",
    "MinimalistStyle",
    "OfficeFashion"
  ],
  "tagCount": 4,
  "tagList": [
    {
      "id": "5befe9e0ffd6080001cbb9cb",
      "name": "AutumnOOTD",
      "type": "topic"
    },
    {
      "id": "53b4d29ab4c4d61b0ba2ee94",
      "name": "CapsuleWardrobe",
      "type": "topic"
    }
  ],
  "mentions": [],
  "mentionCount": 0,
  "atUsers": [],
  "publishedAt": "2026-09-15T08:24:10+00:00",
  "updatedAt": "2026-09-15T09:12:05+00:00",
  "sentiment": {
    "hasPurchaseIntent": true,
    "hasInquiry": true,
    "hasPraise": true,
    "intentKeywords": [
      "哪里买",
      "求链接",
      "多少钱"
    ],
    "emojis": ["✨", "🍂", "🧥"]
  },
  "scrapedAt": "2026-09-18T01:43:26.549000+00:00"
}

💰 Transparent Pay-Per-Result Pricing

This Actor operates under Apify's Pay-Per-Event (PPE) model. You only pay for actual delivered data with no recurring monthly subscriptions:

Event Price What You Get
Actor Run Startup (apify-actor-start) $0.05 Per execution. Covers browser session initialization and anti-bot verification.
Scraped Note (note) $0.002 / post Charged only for valid, complete note items delivered to your dataset.

⚡ Ready-to-Run Use Case Tasks

Save time with our pre-configured, 1-click tasks optimized for specific scraping goals:

Use Case Objective 1-Click Task Preset Key Focus Direct Run
👗 Fashion & OOTD Trends xiaohongshu-fashion-ootd-trends Viral Korean aesthetics, capsule wardrobes, luxury streetwear ⚡ Open & Run
💄 Beauty & Skincare Scraper xiaohongshu-beauty-skincare-scraper Cosmetic product reviews, Asian skincare routines, and makeup tutorials ⚡ Open & Run
🎬 Viral Video Extractor xiaohongshu-viral-video-downloader Direct unwatermarked MP4 streams, video durations, and viral reels ⚡ Open & Run
🍜 Food & Restaurant Guide xiaohongshu-food-restaurant-guide Dining guides, cafe reviews, local foodie spots, and recipes ⚡ Open & Run
✈️ Travel & Outdoor Guides xiaohongshu-travel-outdoor-guide Viral itineraries, hidden scenic gems, camping, and weekend guides ⚡ Open & Run
🛋️ Home Decor & Aesthetics xiaohongshu-home-decor-lifestyle Room makeovers, minimalist interior design, and cozy living setups ⚡ Open & Run
🏃 Fitness & Wellness Tracker xiaohongshu-fitness-wellness-tracker Workout routines, healthy meal plans, and fat loss transformations ⚡ Open & Run
🎮 Gaming & Anime Culture xiaohongshu-gaming-anime-trends ACG culture, cosplay, gaming strategies, and mobile game updates ⚡ Open & Run
🛍️ Buyer Sentiment & Reviews xiaohongshu-buyer-sentiment-analyzer Authentic consumer feedback, complaints, and purchase intent ⚡ Open & Run
🌟 Influencer (KOL/KOC) Tracker xiaohongshu-influencer-kol-tracker Creator discovery, RED ID handles, and viral engagement metrics ⚡ Open & Run


🔌 MCP Server Setup: Claude Code, Cursor & AI Agents

Connect this scraper directly to Claude Code, Claude Desktop, Cursor, or any MCP-compatible AI agent via the hosted Apify MCP server:

{
  "mcpServers": {
    "apify": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=actors,docs,unitbytes/xiaohongshu-rednote-trend-scraper"
    }
  }
}

No manual API token required in configuration if your client supports Apify OAuth sign-in. Alternatively, pass your Apify API Token in the authorization header.


🤖 Ask an AI Assistant About This Scraper

Open a ready-to-run prompt about Xiaohongshu (RedNote) Trend Scraper in your favorite AI assistant:


❓ Frequently Asked Questions (FAQ)

Do I need a Xiaohongshu account or personal login cookies?

No. This Actor operates 100% autonomously without asking users for login cookies. You do not need to risk your personal account or deal with expiring session tokens.

Can I download watermark-free MP4 videos?

Yes. When enrichDetails: true is enabled, the actor extracts the signed, direct MP4 streaming link (videoUrl) without watermarks.

Are the extracted images and photos hotlink-free and accessible?

Yes. All photo gallery links, covers, and author avatars are hotlink-free HTTPS URLs. They can be opened directly in any browser, embedded into web applications, or viewed in spreadsheets and dashboards without access restrictions.

Can I scrape more than 30 notes per run?

Yes. The scraper supports continuous multi-page pagination across pages 1, 2, 3, etc. Simply set maxItems to your desired count (e.g. 500, 1,000, 5,000, 10,000+).

Can I paste mobile share links from the Xiaohongshu app?

Yes. You can paste short mobile share links (http://xhslink.com/a/...) directly into noteUrls or startUrls. The actor automatically resolves them to full post IDs.

Can I search with English keywords?

Yes. You can search using English words (e.g. OOTD, skincare, vintage), Chinese characters, Pinyin, or hashtags.


📊 Export Formats & Integrations

Your scraped Xiaohongshu dataset can be downloaded or integrated with any modern data pipeline:

  • Downloadable Formats: CSV, Excel (XLSX), JSON, JSONL, XML, HTML Table.
  • Automation & Integrations: Connect to Google Sheets, Airtable, Zapier, Make.com, or Slack using Apify Webhooks.
  • Developer API: Programmatically query results via Python (apify-client), Node.js / JavaScript, or standard cURL REST API.

Ready to extract viral Xiaohongshu trends & consumer sentiment?

Try it for Free on Apify


💬 Enterprise Support & Custom Pipelines

Need custom web data feeds, high-frequency scheduled runs, private cluster deployments, or dedicated SLAs?

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

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors