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.55 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. Trending / category feeds and note_detail run without a login; 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 (no cookie needed). '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. Works without a cookie. If the requested category tab cannot…
cookie	string		REQUIRED for '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.

中文说明

小红书(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. Without a valid logged-in cookie those three modes fail as BLOCKED with 0 rows and 0 result charges (the start fee still applies); they do not fall back to the explore feed. trending (all categories) and note_detail work without a cookie: since October 2026 the anonymous trending feed is read from RedNote's server-rendered explore page through a China residential proxy session (about 30 notes per session, sessions rotated until limit), because the interactive feed now shows a login modal to anonymous browsers.

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" }

Run it on a schedule

A daily run suits trending and category feeds, because what RedNote surfaces on those feeds turns over quickly. Between runs you get new notes on the feed, and notes you have seen before can come back with higher likes, comments, shares and saves. Keyword, hashtag and user runs can also be scheduled, but they need a valid logged-in cookie and will fail without one. The actor has no new-only mode, so use post_id to match notes across runs. Send each run's results onward with a webhook, Google Sheets, Zapier, Make or the Apify API.

Video guides from Apify: Schedule your Actor · Integrations

FAQ

Why use this instead of the official RedNote app or website?

RedNote is built for browsing, not for exporting data. This actor turns trending feeds, category channels, note detail, and (with your cookie) keyword, hashtag and user results into clean JSON with English field names and engagement counts. It needs no API key, comes set up to use the China residential proxy that RedNote requires, and can run on a schedule. You do not need to read Chinese to use the output.

What does a typical run cost?

You pay per result, not for run time: $0.02 for each row in the results, plus $0.05 per run start (charged per GB of run memory, minimum one). A run that returns 5 RedNote posts costs about $0.15. Live prices are always shown in the Pricing tab.

Can I scrape Xiaohongshu without logging in?

Yes, for trending (all category channels) and note_detail. The keyword_search, hashtag and user_posts modes hit RedNote's login wall and need a logged-in cookie. Without one, those runs fail as blocked with no rows and no result charges. They never swap in the explore feed instead.

Does it return the comments on a RedNote note?

No. note_detail returns comments_count only, not the comment text. In trending mode the feed gives card summaries, so body and posted_at can be empty. Run note_detail on a note's url to get the full text and timestamp.

How many RedNote posts can one run return?

Up to 200 per run, set with limit. Search modes take up to 10 keywords, hashtags or users per run, and each one is a separate browser session that shares the run's time budget. If time runs out, the run delivers what it finished and its status message says how many queries were not processed.

Related actors

• RedNote (Xiaohongshu) Note Detail Scraper · 小红书笔记详情采集 — a dedicated actor for full note detail.
• Xiaohongshu Trends Tracker · 小红书趋势追踪 — follow trend topics on the same platform.
• Weibo Hot Search Tracker · 微博热搜 API & Trend Monitor — see what is trending on Weibo at the same time.
• Douyin Trending Tracker - Chinese TikTok Hot List — add the Douyin hot list to your China consumer watch.
• China Trends Tracker · 中国趋势汇总(微博/百度/头条/抖音) — one feed across several Chinese trend boards.