Xiaohongshu (RedNote) Pro Scraper

Full-featured Xiaohongshu / 小红书 / RedNote scraper. Five modes, one Actor, clean structured JSON. No login, no cookies, no broken-token surprises.

Built for serious workloads — market research teams pulling daily competitive intelligence, AI training pipelines harvesting Chinese-language UGC, KOL discovery tools, brand-watch dashboards.

What does this Actor do?

Pick a mode, give it inputs, get a dataset:

• Keyword search — search Xiaohongshu by keyword with full sort and filter options (newest, most liked, video-only, last 24h, etc.)
• Note details — paste a note URL, get the full body, all images, hashtags, engagement counts, location, and optional comments.
• User profile + posts — fetch a creator's profile (followers, IP location, bio) plus their recent posts in one run.
• Topic / hashtag feed — pull every recent note tagged with a topic.
• Public trending feed — the anonymous "Hot Notes" homepage strip, no Xiaohongshu account needed.

Each note returns a flat, schema-validated JSON row that's downloadable as JSON, CSV, Excel, HTML, or XML — and queryable via the Apify REST API for pipeline integration.

Why use Xiaohongshu Pro Scraper?

• No cookies, no breakage. Other Xiaohongshu actors in the store rely on the user's logged-in cookie which expires every few days. Customers end up with a stream of 401s and 1.5★ reviews. We use a maintained mobile-app endpoint that stays stable.
• Five modes in one Actor. Search, note detail, user, topic, trending — pick a mode per run; no juggling separate Actors.
• Full-field output. Title, body text, author, likes, collects, comment count, hashtags, image gallery, video URL, publish time, geo / IP location — all in one row.
• AI training-ready. Chinese-language UGC, clean JSON, deduplicable by noteId. Drop straight into a vector DB, an LLM fine-tune set, or a trend classifier.
• Marketing dashboards. Schedule keyword runs hourly and build a real-time pulse of any brand, product, or hashtag.

How to use

1. Open the Actor and click Try for free.
2. In the Input tab, pick a Scrape mode (search is the default).
3. Fill the inputs for your mode:
   • search: keywords, optional sort/filter
   • notes: full note URLs
   • user: user IDs
   • topic: topic names (without #)
   • trending: nothing required
4. Set Max items per input (default 30).
5. Click Save & Start. Results stream into the dataset live.
6. Download or stream the dataset; schedule the run under the Schedules tab.

Input

Field	Type	Used in mode	Description
mode	string	all	One of search, notes, user, topic, trending.
keywords	array	search	Keywords to search.
noteUrls	array	notes	Note URLs to fetch details for.
userIds	array	user	User IDs to fetch profiles and posts for.
topicNames	array	topic	Topic / hashtag names (without #).
maxItemsPerInput	integer (1–500)	all	Cap per input. Default 30.
sortType	enum	search	general / time_descending / popularity_descending / comment_descending / collect_descending.
noteType	enum	search	不限 / 视频笔记 / 普通笔记 / 直播笔记.
timeFilter	enum	search	不限 / 一天内 / 一周内 / 半年内.
fetchComments	boolean	notes, search	Also fetch up to 20 top comments per note. Extra cost.
proxyConfiguration	object	trending only	Only used for trending fallback.

JSON example — keyword search:

{
    "mode": "search",
    "keywords": ["AI编程", "护肤"],
    "maxItemsPerInput": 100,
    "sortType": "popularity_descending",
    "timeFilter": "一周内",
    "fetchComments": false
}

Output

{
    "noteId": "69fba039000000003803426d",
    "title": "Claude Code 零基础终极教程！",
    "bodyText": "这是你能看到的最完整的Claude Code 零基础系统教程。 🔹 从安装到接入第三方模型 🔹 讲透 Hooks、S…",
    "author": "木子不写代码",
    "authorId": "5e2a3c1d000000000100abc7",
    "likes": 117895,
    "collects": 172097,
    "commentsCount": 4521,
    "isVideo": true,
    "imageUrls": [
        "https://sns-webpic-qc.xhscdn.com/.../1.jpg"
    ],
    "videoUrl": "https://sns-video-bd.xhscdn.com/.../master.mp4",
    "hashtags": ["#ClaudeCode", "#AI编程", "#提示词"],
    "publishedAt": "2026-04-13T09:42:00.000Z",
    "location": "上海",
    "comments": [
        { "author": "用户A", "text": "太实用！", "likes": 42 }
    ],
    "noteUrl": "https://www.xiaohongshu.com/explore/69fba039000000003803426d",
    "keyword": "AI编程",
    "scrapedAt": "2026-05-22T09:26:33.733Z"
}

Output fields

Field	Description
noteId	Xiaohongshu's internal note ID.
title	Note title.
bodyText	Full note body text.
author	Display name of the author.
authorId	Internal user ID — pair with mode: "user" to drill into the author.
likes	Like count.
collects	Collect (favourite) count.
commentsCount	Total comment count.
isVideo	True if Xiaohongshu marks the note as a video.
imageUrls	All images in the note.
videoUrl	Video src for video notes.
hashtags	Hashtags / topics referenced.
publishedAt	ISO 8601 publish time.
location	Author IP location (city / region).
comments	Up to 20 top comments when fetchComments is on.
noteUrl	Public deep link.
keyword	Search keyword that surfaced this note (search mode only).
topic	Topic name (topic mode only).
userId	Author ID (user mode only).
scrapedAt	ISO 8601 timestamp of scrape.

Pricing

$3.99 per 1,000 results. Each note returned counts as one result. Detail mode with fetchComments=true returns richer rows but is billed at the same rate.

Cost estimates

Goal	Items / run	Mode	Est. cost / run
Quick scan of one keyword	50	search	~$0.20
Hashtag round-up	500	search	~$2.00
KOL deep dive	200 + comments	notes	~$0.80
Daily brand monitoring	1,000	search	~$4.00 / day

Apify also charges a small compute fee (typically $0.01-0.05 per minute of run time).

Tips

• Schedule, don't poll. Xiaohongshu rotates trending content every few hours; scheduling daily / 6-hourly delivers the right cadence vs cost.
• Deduplicate by noteId. Sequential runs overlap; merge and dedupe on the noteId field.
• Pair user + notes modes. Use mode: "user" to find prolific authors, then drill into each top note with mode: "notes".
• Pair popularity_descending with timeFilter: "一周内" to surface this week's breakout posts.
• Don't enable fetchComments unless you need them. Each comment-bearing note takes an extra request and doubles per-row time.

FAQ

Q: Why is this Actor different from the other Xiaohongshu scrapers on the Store? A: Most existing actors depend on the customer providing a logged-in Xiaohongshu cookie that expires every few days. We don't. We've engineered around the public mobile-app surface so the Actor stays stable across cookie expiries.

Q: Will this break when Xiaohongshu changes their API? A: Possibly. Our team maintains the backend; we patch usually within 24-72 hours of a backend change. Bug reports via the Issues tab.

Q: Is scraping Xiaohongshu legal? A: We pull only publicly-accessible content — what any visitor can see without an account. Your usage is your responsibility; comply with your jurisdiction's law and Xiaohongshu's Terms of Service. Do not scrape private profiles or use the data to identify individuals.

Q: Can I get my data via API? A: Yes. Every Apify run exposes a stable REST API for inputs, datasets, and run status. Plug into n8n, Make, Zapier, or your own pipeline.

Q: Is there a free tier? A: The Apify platform gives every new account $5 in free credit — enough for ~1,000 results to evaluate the Actor before committing. The trending mode in this Actor is also free of per-result charges (it runs on Apify residential proxies; you pay only compute).

Q: How fast are runs? A: Search mode: ~5 seconds per page (≈20 notes). User mode: ~3 seconds per page. Note-detail mode: 1-2 seconds per note. Topic mode: ~4 seconds per page.

Q: I need a richer integration or higher-volume contract. A: Reach out via Apify chat. Custom endpoints, dedicated proxies, and SLAs available on request.