RedNote (Xiaohongshu) Scraper -- All-in-One

The only RedNote scraper you need. One Actor that replaces six separate tools -- search posts, extract user content, download videos, scrape comments, and get profile data. Clean JSON output, reliable, and maintained.

One Actor, Six Capabilities

Mode	What it does	Input needed
Search	Find posts by keyword with filters	Search query
User Posts	Get all posts from a user's profile	User URL or ID
Post Details	Extract full data from specific posts	Post URL(s)
Comments	Scrape all comments from a post	Post URL(s)
Video Download	Get direct video download URLs	Post URL(s)
User Profile	Extract profile data (bio, followers, etc.)	User URL or ID

Why This Scraper?

• All-in-one: No need to juggle 6 different Actors for different tasks
• Clean output: Structured JSON with consistent schema across all modes
• Actually works: Built with Playwright for reliable rendering of RedNote's SPA
• Smart extraction: Uses Vue state data when available, falls back to DOM parsing
• Anti-detection: Stealth browser configuration, random delays, residential proxy support
• Honest about limitations: Documents what works and what doesn't

Use Cases

• Brand monitoring: Track mentions and sentiment about your brand on China's hottest social platform
• Influencer research: Find creators, analyze their content and engagement metrics
• Competitive analysis: Monitor competitor activity and popular content in your niche
• Trend discovery: Search for trending topics, products, and content styles
• Content research: Study what performs well before creating your own content strategy

Input Examples

Search for posts

{
    "mode": "search",
    "searchQuery": "skincare routine",
    "maxResults": 50,
    "sortBy": "popularity_descending",
    "filterByType": "all",
    "filterByMinLikes": 100
}

Get a user's posts

{
    "mode": "user_posts",
    "userUrl": "https://www.xiaohongshu.com/user/profile/5d7439b40000000001009f54",
    "maxResults": 100
}

Get full details for specific posts

{
    "mode": "post_details",
    "postUrls": [
        "https://www.xiaohongshu.com/explore/643fa30c000000001303f836",
        "https://www.xiaohongshu.com/explore/640b414e000000001300238a"
    ]
}

Extract comments

{
    "mode": "comments",
    "postUrls": ["https://www.xiaohongshu.com/explore/643fa30c000000001303f836"],
    "maxComments": 200
}

Download video URL

{
    "mode": "video",
    "postUrls": ["https://www.xiaohongshu.com/explore/VIDEO_POST_ID"]
}

Get user profile

{
    "mode": "profile",
    "userUrl": "https://www.xiaohongshu.com/user/profile/5d7439b40000000001009f54"
}

Output Schema

Post output (search, user_posts, post_details)

{
    "mode": "search",
    "postId": "643fa30c000000001303f836",
    "postUrl": "https://www.xiaohongshu.com/explore/643fa30c000000001303f836",
    "type": "normal",
    "title": "My Morning Skincare Routine",
    "content": "Full text of the post...",
    "images": ["https://cdn.xiaohongshu.com/image1.jpg"],
    "videoUrl": null,
    "likes": 15234,
    "comments": 423,
    "shares": 89,
    "saves": 1567,
    "tags": ["skincare", "routine"],
    "author": {
        "userId": "user123",
        "nickname": "BeautyQueen",
        "avatar": "https://cdn.xiaohongshu.com/avatar.jpg"
    },
    "publishedAt": "2026-03-15T10:30:00Z",
    "scrapedAt": "2026-04-07T12:00:00Z"
}

Profile output

{
    "mode": "profile",
    "userId": "5d7439b40000000001009f54",
    "profileUrl": "https://www.xiaohongshu.com/user/profile/5d7439b40000000001009f54",
    "nickname": "BeautyQueen",
    "description": "Sharing my daily skincare tips",
    "followers": 50000,
    "following": 320,
    "totalLikes": 1200000,
    "notesCount": 156,
    "isVerified": false,
    "scrapedAt": "2026-04-07T12:00:00Z"
}

Comment output

{
    "mode": "comments",
    "postId": "643fa30c000000001303f836",
    "postUrl": "https://www.xiaohongshu.com/explore/643fa30c000000001303f836",
    "authorName": "user456",
    "content": "Love this routine!",
    "likes": 42,
    "publishedAt": "2 days ago",
    "scrapedAt": "2026-04-07T12:00:00Z"
}

Pricing

This Actor uses Pay-Per-Event pricing. You only pay for the results you get:

Event	Price	Description
post-scraped	$0.005	Each post extracted (search results, user posts, post details)
comment-scraped	$0.001	Each comment extracted
profile-scraped	$0.01	Each user profile extracted
video-extracted	$0.01	Each video URL extracted

Example costs:

• Search 100 posts: ~$0.50
• Scrape 500 posts from a user: ~$2.50
• Extract comments (200 comments): ~$0.20
• Get 10 user profiles: ~$0.10

Platform compute costs (Apify usage) are charged separately.

Proxy Configuration

RedNote blocks datacenter IPs. Residential proxies are required for reliable scraping.

The default configuration uses Apify's residential proxy group. If you're using custom proxies, make sure they are residential IPs.

Limitations

• Best modes: search, user_posts, and profile work best. These modes extract data directly from the feed and profile pages.
• Post details/comments/video: These modes require post-specific authentication tokens. They work best for posts that appear in the current feed. For individual posts not in the feed, use search or user_posts mode to get the data instead.
• Login wall: Some content (especially search results beyond the first page) may be limited by RedNote's login requirement. The scraper extracts everything available without login.
• Rate limiting: The scraper enforces 3-8 second delays between requests to avoid IP bans. Large scrapes will take time.
• Content language: Most content on RedNote is in Chinese. The scraper returns content as-is without translation.
• Data freshness: Engagement metrics (likes, comments, shares) reflect the values at the time of scraping.

FAQ

Q: Why do I get fewer results than expected? A: RedNote may limit content visibility for non-logged-in users. The scraper extracts everything available. If you're getting empty results, try with residential proxies.

Q: Can I scrape in languages other than Chinese? A: Yes! RedNote has growing English and multilingual content. Just search in any language.

Q: How fast is the scraper? A: Due to rate limiting requirements, expect ~10-20 posts per minute. This is intentionally slow to avoid IP bans and ensure reliable scraping.

Q: Does this work with short links (xhslink.com)? A: Yes, the scraper handles RedNote short links and resolves them automatically.