XiaoHongShu (RedNote) Scraper — Notes, Search & Comments 小红书

Scrape XiaoHongShu (小红书 / RedNote) notes by keyword search: titles, full text, authors, engagement stats (likes / collects / comments / shares), images, video URLs, publish time and top comments — delivered as clean JSON via the Apify API.

XiaoHongShu has no public API. This actor drives a real headless browser (Playwright) against the xiaohongshu.com web app and extracts structured data from rendered pages, so you get exactly what a logged-in user sees.

Built for CN/SEA e-commerce operators, US agencies, brand monitoring and trend research pipelines.

What it does

1. Opens xiaohongshu.com search for each of your keywords.
2. Scrolls the result feed and collects up to maxNotesPerKeyword note cards.
3. Opens every note page and extracts the full note: title, description, hashtags, author, likes, collects, comment count, share count, publish time, all images, video URL.
4. Optionally scrolls the comment section and collects up to maxCommentsPerNote top-level comments per note (user, text, likes).
5. Pushes one dataset item per note — ready for export as JSON / CSV / Excel or API consumption.

⚠️ Keyless vs. cookies — read this before running

XiaoHongShu aggressively gates its web app behind login. Here is exactly what works, verified live:

Feature	Without cookies	With login cookies
Keyword search results	❌ Blocked — the search page shows a login wall and renders zero note cards	✅ Works
Note detail pages (title, author, stats, images)	✅ Works*	✅ Works
Comments on note pages	✅ Works* (login popup auto-dismissed)	✅ Works

* …but without keyword search there is nothing to feed the detail extractor, so a keyless run normally produces 0 items.

Bottom line: set the cookies input. Without it the actor still runs, warns loudly, and returns an empty dataset.

How to get your cookies

1. Log in to xiaohongshu.com in Chrome/Edge (phone SMS or QR scan).
2. Open DevTools (F12) → Network tab → refresh the page.
3. Click any request to xiaohongshu.com → copy the full Cookie: request header value.
4. Paste it into the cookies input. It looks like a1=abc123; webId=def456; web_session=....

Cookies typically last days to weeks. If a run with cookies returns 0 notes, grab fresh ones.

Input

Field	Type	Default	Description
keywords	string[]	["护肤 推荐"]	Search keywords (Chinese or English). One search run per keyword. Required.
maxNotesPerKeyword	integer	20	Max notes scraped per keyword (1–200).
maxCommentsPerNote	integer	0	Max top-level comments per note. 0 skips comment extraction entirely (much faster).
cookies	string	—	Browser cookies for xiaohongshu.com (name=value; name=value). Strongly recommended — see above.
proxyConfiguration	object	—	Optional Apify proxy. Residential proxies help if you hit rate limits.

Example input

{
  "keywords": ["护肤 推荐", "夏日穿搭"],
  "maxNotesPerKeyword": 20,
  "maxCommentsPerNote": 5,
  "cookies": "a1=yourCookieValue; webId=yourCookieValue; web_session=yourCookieValue"
}

Output

One dataset item per note:

Field	Type	Description
keyword	string	Keyword that found this note
noteId	string	XiaoHongShu note ID
url	string	Canonical note URL
type	string	note (image/text) or video
title	string	Note title
desc	string	Body text incl. hashtags
authorName	string	Author nickname
authorId	string	Author user ID
authorUrl	string	Author profile URL
likes	string	Like count as displayed (e.g. 2.4万)
collects	string	Collect/favorite count
commentsCount	string	Total comment count
shareCount	string	Share count
publishTime	string	ISO publish timestamp
images	string[]	Image URLs
videoUrl	string	Video URL (video notes only, else null)
comments	object[]	{userName, text, likes} — empty when comment extraction is off
scrapedAt	string	ISO timestamp of scraping

Example item

{
  "keyword": "护肤",
  "noteId": "6a64f1c60000000010026e57",
  "url": "https://www.xiaohongshu.com/explore/6a64f1c60000000010026e57",
  "type": "note",
  "title": "讨厌夏天",
  "desc": "没有鲨人！但是是真的心好累……",
  "authorName": "+こおり+",
  "authorId": "699af24b000000001c037d61",
  "authorUrl": "https://www.xiaohongshu.com/user/profile/699af24b000000001c037d61",
  "likes": "2.4万",
  "collects": "1497",
  "commentsCount": "2153",
  "shareCount": "6106",
  "publishTime": "2026-07-25T16:06:30.000Z",
  "images": ["http://sns-webpic-qc.xhscdn.com/..."],
  "videoUrl": null,
  "comments": [
    { "userName": "+こおり+", "text": "你们点赞的是啥意思呀！", "likes": "1千+" }
  ],
  "scrapedAt": "2026-08-19T18:00:00.000Z"
}

Pricing (pay per event)

• $3.00 per 1,000 notes scraped
• $0.005 per comment extracted
• No start fee — you only pay for successfully scraped data

Set maxCommentsPerNote: 0 if you don't need comments — note-only runs are fast and cheap.

Tips & limits

• Rate limits: XiaoHongShu throttles aggressively. Anonymous (no-cookie) access from one IP is cut off entirely after a burst of requests — with cookies, keep volumes modest per account, or attach a residential proxy (Chinese IPs work best; datacenter IPs are often pre-blocked).
• Login wall popups on note pages are auto-dismissed by the actor.
• Counts like likes are returned as displayed on the site (2.4万 = 24,000) — convert in post-processing if you need raw numbers.
• Deleted or private notes are skipped with a warning.

Legal

This actor extracts publicly visible data from xiaohongshu.com. You are responsible for complying with XiaoHongShu's Terms of Service and applicable law. Use your own account cookies at your own risk.