Building a Watermark-Free Xiaohongshu Downloader: Technical Challenges and Anti-Scraping Strategies

Description and use

The author built a free web tool to download Xiaohongshu content without watermarks. Using Next.js and Redis, the solution bypasses CDN-level watermarking by fetching original source URLs. It handles various link formats and implements anti-blocking measures like caching and rate limiting. Surprisingly, Indonesia emerged as the primary user base.

Problem

Users need a reliable way to download videos and images from Xiaohongshu (RedNote) without watermarks, poor quality, or security risks associated with third-party APKs and sketchy online tools.

Outcome

The author successfully built a lightweight Next.js application that bypasses Xiaohongshu's CDN watermarks by fetching original source URLs. The tool handles complex link formats, implements anti-scraping countermeasures like caching and throttling, and serves a significant international audience, particularly from Indonesia.

Workflow

• User pastes a Xiaohongshu share link (short link, full text, or explore URL).
• Link Parser detects format and resolves redirects.
• System checks Redis cache for existing results.
• If cache miss, Metadata Fetcher generates signatures, handles cookies, and calls the API.
• Media Extractor identifies direct CDN source URLs for videos or images.
• System serves a preview card with title, author, and thumbnail.
• User downloads the file via direct CDN URL or proxied stream.

Evidence

Xiaohongshu's watermark isn't burned into the original file. It's applied at the CDN layer when served through certain endpoints. The original MP4 on the CDN source is clean.

Source

63% of my traffic comes from Indonesia.

Source

Total infra cost: under $20/month at current traffic (~15k visits/month).

Source