Xiaohongshu Scraper — RedNote Scraper for Trending & Notes

A Xiaohongshu scraper (also searched as a RedNote scraper) for trending feeds, category channels, note detail and user posts.

Pricing: $0.02 per post returned plus a $0.05 Actor Start fee per run. The default limit of 25 posts costs $0.50 + $0.05 = $0.02 per run; $1.00 buys one run of ~47 posts ($0.05 start + 47 × $0.02). Runs that return 0 posts (blocked, failed, or genuinely empty) pay only the start fee.

Pull RedNote (Xiaohongshu, 小红书) trending notes, category discovery feeds, keyword / hashtag / user search results and full note detail as clean JSON. Western brand and sourcing teams use it to read China's earliest publicly observable consumer-demand signal: on RedNote, nearly every viral note is a product review or buying guide, surfacing weeks before Tmall or JD sales rankings. note_detail runs without a login; trending / category feeds (since October 2026), keyword search, hashtag and user-posts modes are login-gated by RedNote and require a logged-in cookie. No Mandarin-speaking analyst in Shanghai required.

📊 Sample Output

post_id	author_id	title	hashtags	posted_at	category
6a7005110000000008010ab1	66e567b9000000000b031bd3	这就是早期A萍吗	['瑶一瑶小肉包', '早期A萍', '女宝', '瑶总']	2026-08-03T03:50:06Z	lifestyle

Real rows from run ANLjvC2DwnYL44lJx on build 0.0.40 (2026-09-24), unedited apart from masked emails/phones and shortened long text; fields the source does not publish are empty.

🔧 Input reference

Field	Type	Default	What it does
mode	string (trending, keyword_search, hashtag, user_posts, note_detail, topic_probe)	"note_detail"	What to scrape. 'trending' pulls the homepage discovery feed or a category channel (logged-in cookie required since October 2026). 'keyword_search' searches RedNote for the terms in 'keywords' (Chinese or En…
category	string (recommend, fashion, food, cosmetics, movie, career, love, home, …)	"recommend"	For 'trending' mode: which explore feed to pull. 'recommend' = the default mixed feed; or pick a category channel tab. Needs the same logged-in cookie as 'trending'. If the requested category tab cannot…
cookie	string		REQUIRED for 'trending', 'keyword_search', 'hashtag' and 'user_posts': RedNote serves a login wall to anonymous visitors in these modes, and without a valid logged-in cookie the run fails as…
keywords	array	["护肤", "口红", "穿搭"]	List of search terms for 'keyword_search' mode (max 10 per run — each keyword is a separate 60-115 s browser session, so the run's time budget is shared across them). Chinese char…
hashtags	array	["秋冬穿搭"]	List of RedNote hashtags/topics to pull posts for in 'hashtag' mode (max 10 per run). Provide the tag text without the leading '#' (e.g. ['秋冬穿搭', '咖啡探店']). Each tag is resolved th…
users	array	[]	List of RedNote user references for 'user_posts' mode (max 10 per run). Accepts a full profile URL (https://www.xiaohongshu.com/user/profile/{id}), a path (/user/profile/{id}), or…
note_urls	array	["https://www.xiaohongshu.com/explore/6a7005110000000008010…	For 'note_detail' mode: RedNote note URLs (best with xsec_token, e.g. https://www.xiaohongshu.com/explore/?xsec_token=...) or bare note IDs. Returns the full body text plus likes…
limit	integer	5	Maximum number of RedNote posts to return per run (across all keywords / hashtags / users). Default 25 (billed: 25 × $0.02 = $0.50 + the $0.05 Actor Start fee). Maximum 200 — the…
proxyConfiguration	object	{"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]…	Apify proxy configuration. RESIDENTIAL is required — RedNote is hosted in mainland China and blocks datacenter IPs (403/461 or empty feeds). The default exit is pinned to CN resid…

🧾 JSON sample record

One real record from run ANLjvC2DwnYL44lJx (emails/phones masked, long text shortened):

{
  "post_id": "6a7005110000000008010ab1",
  "author": "安念",
  "author_id": "66e567b9000000000b031bd3",
  "title": "这就是早期A萍吗",
  "body": "第一张都可以当氛围感头像了，太好看了吧。不知道瑶总长大是什么样子[害羞R]#瑶一瑶小肉包[话题]# #早期A萍[话题]# #女宝[话题]# #瑶总[话题]#",
  "image_urls": [
    "http://sns-webpic-qc.xhscdn.com/202609250756/9f818c5e7c3bd3df5ace9db71e92bdcf/1040g008323d2nup6nu6g5pn5cusiu6ujpa52j8o!nd_dft_wlteh_webp_3",
    "http://sns-webpic-qc.xhscdn.com/202609250756/bcbffbfafd392c9a60ba914ade67caad/1040g008323d2nup6nu605pn5cusiu6ujlts7bvg!nd_dft_wlteh_webp_3",
    "http://sns-webpic-qc.xhscdn.com/202609250756/f14acfcfb0b18f6cf4e031e35a5346a8/1040g008323d2nup6nu5g5pn5cusiu6uje85thp8!nd_dft_wlteh_webp_3",
    "http://sns-webpic-qc.xhscdn.com/202609250756/426740fbfb7c752f36bb1e044bd25a96/1040g008323d2nup6nu505pn5cusiu6ujmguh5cg!nd_dft_wlteh_webp_3",
    "http://sns-webpic-qc.xhscdn.com/202609250756/924b6980ced9a8a82403c0fe9da48103/1040g008323d2nup6nu005pn5cusiu6uj12h3puo!nd_dft_wlteh_webp_3"
  ],
  "hashtags": [
    "瑶一瑶小肉包",
    "早期A萍",
    "女宝",
    "瑶总"
  ],
  "likes_count": 72,
  "comments_count": 218,
  "shares_count": 14,
  "collected_count": 8,
  "engagement_total": 312,
  "posted_at": "2026-08-03T03:50:06Z",
  "url": "https://www.xiaohongshu.com/explore/6a7005110000000008010ab1?xsec_token=ABurwOqJq_s4gjlW8rY2CXHDbBbo2fLHfKs8qFwpVaby4=&xsec_source=pc_search",
  "category": "lifestyle",
  "mode": "note_detail",
  "query": "https://www.xiaohongshu.com/explore/6a7005110000000008010ab1?xsec_token=ABurwOqJq_s4gjlW8rY2CXHDbBbo2fLHfKs8qFwpVaby4=&xsec_source=pc_search",
  "data_source": "xiaohongshu.com (SSR, cookieless)",
  "as_of_timestamp": "2026-09-24T23:56:12Z",
  "source_url": "https://www.xiaohongshu.com/explore/6a7005110000000008010ab1?xsec_token=ABurwOqJq_s4gjlW8rY2CXHDbBbo2fLHfKs8qFwpVaby4=&xsec_source=pc_search"
}

💰 Pricing

Event	Price (USD)	When it is charged
Actor Start (apify-actor-start)	$0.05	Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event).
RedNote post (apify-default-dataset-item)	$0.02	Charged per RedNote post returned.

Pay-per-event: you pay only for what the run delivers. A run that delivers nothing bills no result events (only the actor-start event, when the actor defines one). Example: a run that delivers 100 results costs 100 × $0.02 = $2.00 plus the start fee.

🔗 Related Actors

More from the NexGenData China markets family:

• Douban API — China Movie & TV Ratings, Top 250 & Hot Lists
• IndiaMART Verified Exporter Directory — India B2B Sourcing
• Made-in-China Supplier Scraper — Audited & Verified, by Region
• STAR Market China Screener — 科创板 A股 API
• Weibo Hot Search Tracker · 微博热搜 API & Trend Monitor

19 more in this family on the NexGenData Store page.

中文说明

小红书(RedNote)采集器让你获取小红书的热门内容、分类信息流与笔记数据。每条结果为一篇笔记,可导出为 JSON、CSV 或 Excel,适合品牌、内容营销与消费者研究。

定价:按笔记计费,每条 $0.02,另加每次运行 $0.05 启动费(默认 25 条约 $0.55 一次)。

定时运行:在 Apify 的「Schedules」中新建计划任务,设定关键词或分类,即可定期追踪话题与品类的变化。

AI 智能体:采用按事件计费(PPE),可通过 Apify 的 x402 让智能体用 USDC 直接调用,无需账号。

说明:关键词搜索、话题搜索与用户主页模式必须提供登录 Cookie,否则小红书会弹出登录墙,运行将失败且不产生结果费用;所有字段均来自公开数据。

Modes

Mode	What it does	Cookie?
trending	Homepage discovery feed (category: recommend) or a category channel tab (fashion / food / cosmetics / travel / gaming / fitness / movie / home / love / career / video)	Not needed
note_detail	Full body text + engagement counts (likes / comments / shares / collected) for a note URL or ID. Comment text is not returned — only comments_count.	Not needed
keyword_search	Search by keyword (Chinese or English terms), up to 10 keywords per run	Required
hashtag	Posts for a hashtag / topic (resolved through RedNote's search API), up to 10 tags per run	Required
user_posts	Recent posts by a specific user, up to 10 users per run	Required

topic_probe also exists in the mode list for compatibility. It is a diagnostic mode: it writes to the key-value store only, pushes 0 dataset rows and incurs 0 result charges. It is not a buyer feature.

Cookie requirement, plainly: RedNote serves a login wall to anonymous visitors on search, hashtag and user-profile pages, and since October 2026 on the explore (trending) feed as well — the server redirects a cookieless visit straight to /login (verified 2026-10-05). Without a valid logged-in cookie, trending fails within seconds as configuration_error and the other three modes fail as BLOCKED, all with 0 rows and 0 result charges (the start fee still applies). Only note_detail works without a cookie.

Category feeds, plainly: if the requested category tab cannot be activated on the page, the run fails with category tab unavailable (0 rows, 0 result charges). It never delivers the mixed recommend feed labelled as your category. The category field on each record is the note's own text-classified category (beauty / fashion / food / travel / wellness / tech / finance / lifestyle); the channel you asked for is recorded in query.

Time budget: each keyword / hashtag / user is a separate 60–115 s browser session. The run stops starting new queries 45 s before its timeout and delivers whatever the completed queries produced in one push; the run status message then says delivered X records from Q of N queries; N-Q not processed (time budget). Raise the run timeout or split queries across runs for large lists.

Use cases

1. Track emerging Chinese consumer-product trends before they reach Western markets.
2. Brand monitoring via trending and category feeds.
3. Cross-border e-commerce / DTC product research — spot rising categories early.
4. Build a Chinese-language lifestyle-content corpus for NLP / AI.
5. Competitor and KOL discovery via user_posts (with cookie) and note_detail.

Sample input

{
  "mode": "trending",
  "category": "cosmetics",
  "limit": 50,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "CN" }
}

Output fields

Every mode emits the same field set per note:

post_id, author, author_id, title, body, image_urls, hashtags, likes_count, comments_count, shares_count, collected_count, engagement_total (sum of the four counts), posted_at, url, category, mode, query, data_source, as_of_timestamp. note_detail records additionally carry source_url (the URL actually fetched).

Note: the trending / category feed API returns card summaries, so in trending mode body and posted_at can be null. Use note_detail on a record's url to get the full body and timestamp.

{ "post_id": "65a1f...e3", "author": "美妆日记Amy", "title": "早C晚A空瓶记录", "body": null, "likes_count": 12840, "comments_count": 612, "shares_count": 88, "collected_count": 2310, "engagement_total": 15850, "hashtags": ["护肤","空瓶"], "posted_at": null, "url": "https://www.xiaohongshu.com/explore/65a1f...e3?xsec_token=...", "category": "beauty", "mode": "trending", "query": "cosmetics" }

FAQ

Does this RedNote scraper need a login or cookie? note_detail does not. trending (all categories, since October 2026), keyword_search, hashtag and user_posts do — RedNote shows a login wall to anonymous visitors in those modes and the run fails (0 rows, 0 result charges) without a valid cookie. Log in at xiaohongshu.com, copy document.cookie, and paste it into the cookie input. Using your own account may violate XHS Terms — use at your own risk.

Can it do keyword search on Xiaohongshu? Yes, with a logged-in cookie. Without one it cannot; it does not substitute the explore feed for a search.

Does it return comments? No. note_detail returns comments_count only; comment text is not extracted.

Is scraping Xiaohongshu / RedNote legal? It pulls only content visible to a logged-in or logged-out visitor of the site as configured; it does not bypass login walls or private profiles. Buyers are responsible for compliance with the site's Terms of Service and applicable law.

What data fields are returned per note? See Output fields above — likes_count, comments_count, shares_count, collected_count, engagement_total, hashtags, posted_at, url and the rest.

What is the maximum limit? 200. The trending / category feed can be scrolled about 8 pages (~230 notes) in one run, and search modes share one time budget, so larger values are not reachable and are not accepted by the input schema.

Do I need to read Chinese? No — fields are structured and English-labeled. Chinese keywords give the best native results; English terms work too.

Related NexGenData actors

• Bilibili Video Search
• China Trends Tracker
• Weibo Hot Search Tracker
• Bilibili Video Comments

---

Built and maintained by NexGenData. Home: thenextgennexus.com.