# Xiaohongshu (RedNote) Trend, Note & Sentiment Scraper (`scraperpro/xiaohongshu-rednote-trend-scraper`) Actor
The fastest and most affordable Xiaohongshu (RedNote / 小红书 / XHS) scraper. Viral keyword search, trending channel discovery, 25+ fields, sentiment signals & watermark-free HD media.
- **URL**: https://apify.com/scraperpro/xiaohongshu-rednote-trend-scraper.md
- **Developed by:** [ScraperPro](https://apify.com/scraperpro) (community)
- **Categories:** Social media, E-commerce, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.50 / 1,000 scraped note records
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
## 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**.
***
### 🌟 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 |
| **Setup & Maintenance** | **Instant 1-Click Run** | Broken Sessions / Constant Expiry | Complex Webhooks |
| **Consumer Buying Sentiment** | **Included (Purchase Intent Signals)** | Not Available | Not Available |
| **Media Quality** | **Original Uncompressed HD & MP4** | Low-Res Compressed Thumbnails | Compressed Thumbnails |
| **Official Category Feeds** | **11 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).
- **Watermark-Free Original HD Media:** Extracts uncompressed full-resolution gallery images and direct MP4 video stream links ready for creative research, ad analysis, and content modeling.
- **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 11 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. `Fashion`, `Beauty`, `Food`, `Travel`). |
| `noteUrls` | Array | `[]` | Direct post URLs, bare 24-character hexadecimal IDs, 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"` | 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
- **Fashion & Outfits:** `homefeed.fashion_v3` (穿搭)
- **Beauty & Cosmetics:** `homefeed.cosmetics_v3` (彩妆 / 护肤)
- **Food & Gourmet:** `homefeed.food_v3` (美食 / 探店打卡)
- **Travel & Outdoors:** `homefeed.travel_v3` (旅行 / 露营出行)
- **Home & Interior Decor:** `homefeed.household_product_v3` (家居 / 家装好物)
- **Gaming & Anime:** `homefeed.gaming_v3` (游戏 / 二次元)
- **Fitness & Wellness:** `homefeed.fitness_v3` (健身 / 运动减脂)
- **Movies & Entertainment:** `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)
```json
{
"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)
```json
{
"trendingChannel": "homefeed.fashion_v3",
"maxItems": 50,
"enrichDetails": true
}
```
#### Sample 3: 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)*:
```json
{
"resumptionToken": "REPLACE_WITH_YOUR_RESUMPTION_TOKEN",
"maxItems": 100
}
```
#### Sample 4: Specific Post URLs & Deep Content Extraction
Scrape specific Xiaohongshu posts by URL, mobile share link (`xhslink.com`), or note ID to extract full text, author profiles, watermark-free direct MP4 video URLs, and uncompressed HD galleries:
```json
{
"noteUrls": [
"https://www.xiaohongshu.com/explore/64be807d000000000800dabc",
"http://xhslink.com/a/abc123XYZ"
],
"maxItems": 10,
"enrichDetails": true
}
```
***
### 📤 Output Sample
Each item in your dataset is delivered with enriched structured data:
```json
{
"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-webpic-qc.xhscdn.com/265/user/1040/01f016a7568cc.jpg",
"coverDimensions": {
"width": 1080,
"height": 1440
},
"images": [
"https://sns-webpic-qc.xhscdn.com/265/user/1040/01f016a7568cc_hd.jpg",
"https://sns-webpic-qc.xhscdn.com/265/user/1040/01f016a7568cd_hd.jpg"
],
"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`](https://console.apify.com/actors/tasks/dhqak8m485hih5KIR/input) | Viral Korean aesthetics, capsule wardrobes, luxury streetwear | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/dhqak8m485hih5KIR/input) |
| 💄 **Beauty & Skincare Scraper** | [`xiaohongshu-beauty-skincare-scraper`](https://console.apify.com/actors/tasks/tjjk6L3o5bgfZ5b66/input) | Cosmetic product reviews, Asian skincare routines, and makeup tutorials | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/tjjk6L3o5bgfZ5b66/input) |
| 🎬 **Viral Video Extractor** | [`xiaohongshu-viral-video-downloader`](https://console.apify.com/actors/tasks/0F2TCAZw9bpoTdsxf/input) | Direct unwatermarked MP4 streams, video durations, and viral reels | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/0F2TCAZw9bpoTdsxf/input) |
| 🍜 **Food & Restaurant Guide** | [`xiaohongshu-food-restaurant-guide`](https://console.apify.com/actors/tasks/Tr5SjamLTQaXsqV9R/input) | Dining guides, cafe reviews, local foodie spots, and recipes | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/Tr5SjamLTQaXsqV9R/input) |
| ✈️ **Travel & Outdoor Guides** | [`xiaohongshu-travel-outdoor-guide`](https://console.apify.com/actors/tasks/3tnd4Bxd6slONSZZf/input) | Viral itineraries, hidden scenic gems, camping, and weekend guides | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/3tnd4Bxd6slONSZZf/input) |
| 🛋️ **Home Decor & Aesthetics** | [`xiaohongshu-home-decor-lifestyle`](https://console.apify.com/actors/tasks/mBeTE1mpuVuqGNKls/input) | Room makeovers, minimalist interior design, and cozy living setups | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/mBeTE1mpuVuqGNKls/input) |
| 🏃 **Fitness & Wellness Tracker** | [`xiaohongshu-fitness-wellness-tracker`](https://console.apify.com/actors/tasks/U7rGGzeTmOCER6Soe/input) | Workout routines, healthy meal plans, and fat loss transformations | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/U7rGGzeTmOCER6Soe/input) |
| 🎮 **Gaming & Anime Culture** | [`xiaohongshu-gaming-anime-trends`](https://console.apify.com/actors/tasks/h3ab7k1rx2purFJZO/input) | ACG culture, cosplay, gaming strategies, and mobile game updates | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/h3ab7k1rx2purFJZO/input) |
| 🛍️ **Buyer Sentiment & Reviews** | [`xiaohongshu-buyer-sentiment-analyzer`](https://console.apify.com/actors/tasks/ur8GeX1oo9MvmS79E/input) | Authentic consumer feedback, complaints, and purchase intent | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/ur8GeX1oo9MvmS79E/input) |
| 🌟 **Influencer (KOL/KOC) Tracker** | [`xiaohongshu-influencer-kol-tracker`](https://console.apify.com/actors/tasks/xfcAYwJSHGndGCjKj/input) | Creator discovery, RED ID handles, and viral engagement metrics | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/xfcAYwJSHGndGCjKj/input) |
***
### ❓ 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.
#### 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.
# Actor input Schema
## `startUrls` (type: `array`):
Paste raw Xiaohongshu search URLs (e.g. 'https://www.xiaohongshu.com/search\_result?keyword=OOTD'), category URLs, or direct post links.
## `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.
## `noteUrls` (type: `array`):
Direct Xiaohongshu post URLs (e.g. 'https://www.xiaohongshu.com/explore/64a...'), bare 24-character hex IDs, or mobile share links ('xhslink.com/...') for deep enrichment.
## `maxItems` (type: `integer`):
Maximum number of notes to scrape across all keywords and channels (1 to 10,000).
## `resumptionToken` (type: `string`):
Optional enterprise resumption token copied from a previous run's pagination metadata to resume with exact session continuity.
## `sort` (type: `string`):
Ranking order for note discovery.
## `noteType` (type: `string`):
Filter by media format.
## `enrichDetails` (type: `boolean`):
When enabled, fetches full post body, hashtags, uncompressed HD gallery images, and watermark-free video download link.
## `proxyConfiguration` (type: `object`):
Apify Residential Proxy is recommended for stable, uninterrupted connection.
## Actor input object example
```json
{
"startUrls": [
{
"url": "https://www.xiaohongshu.com/search_result?keyword=OOTD&sort=popularity_descending"
}
],
"keywords": [
"OOTD"
],
"trendingChannel": "none",
"maxItems": 30,
"sort": "popularity_descending",
"noteType": "all",
"enrichDetails": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# Actor output Schema
## `notesDataset` (type: `string`):
Scraped Xiaohongshu notes and viral trend metrics
# 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": [
{
"url": "https://www.xiaohongshu.com/search_result?keyword=OOTD&sort=popularity_descending"
}
],
"keywords": [
"OOTD"
],
"maxItems": 30,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("scraperpro/xiaohongshu-rednote-trend-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": [{ "url": "https://www.xiaohongshu.com/search_result?keyword=OOTD&sort=popularity_descending" }],
"keywords": ["OOTD"],
"maxItems": 30,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("scraperpro/xiaohongshu-rednote-trend-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": [
{
"url": "https://www.xiaohongshu.com/search_result?keyword=OOTD&sort=popularity_descending"
}
],
"keywords": [
"OOTD"
],
"maxItems": 30,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call scraperpro/xiaohongshu-rednote-trend-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,scraperpro/xiaohongshu-rednote-trend-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/HJhq4xB1PKEK6PptD/builds/yud3TwXOhvPtAnWUK/openapi.json