Xiaohongshu (RedNote) Scraper — Notes, Users, Products, Comments & Search 📕

Extract structured data from Xiaohongshu / RedNote (小红书 / XHS / Little Red Book) — China's #1 lifestyle-discovery platform (300M+ MAU). Eight operations in one actor: note details, user profiles, note catalogs, category discovery, mall products & pricing, comments, and keyword search across notes and users. One clean, flat dataset per run.

---

💡 Why use this scraper

• 🔓 Four operations run with no login at all — Note Detail, User Profile, Channel Feed (topical discovery), and Mall Products (prices, sales, sellers) all work as a plain guest. No cookie, no account.
• 🧭 Discover notes without keyword search — browse 12 Xiaohongshu categories (fashion, food, beauty, travel, gaming…) and pull fresh notes with engagement metrics, entirely login-free.
• 🛍️ Real e-commerce data — scrape XHS mall products with current price, discount, units sold, seller, and stock — the pricing/competitor data behind China's biggest lifestyle-commerce platform.
• 🔏 Real request signing, not a fragile reimplementation — the signed operations run Xiaohongshu's own in-page signing, so they survive XHS's signature rotations instead of breaking on them.
• 🎯 Production-ready shape — curated camelCase fields with numeric twins for the Chinese human counts ("1.8万" → 18000).
• 💰 Pay per result — charged only for rows actually returned.

---

📋 Overview

Whether you call it Xiaohongshu, RedNote, Little Red Book, 小红书, or XHS, this actor pulls clean structured data across eight operations:

Operation	What you get	Login needed?
📕 Note Detail	title, description, images, video URL, like/save/comment/share counts, creator, timestamps, tags	No
👤 User Profile	nickname, redId, gender, bio, fans/follows/interaction counts, location	No
🧭 Channel Feed	discover notes across 12 categories (fashion, food, beauty, travel…) with engagement + tokens	No
🛍️ Mall Products	a shop's + related products: price, discount, units sold, seller, stock, brand, image	No
📰 User Notes	a creator's note catalog with engagement metrics	Page 1 free; more needs cookie*
💬 Note Comments	top comments with author, IP location, likes + a reply sample	Cookie*
🔍 Search Notes	keyword → notes (comprehensive / most-popular / newest)	Yes
🧑‍🤝‍🧑 Search Users	keyword → user/KOL results	Yes

* About the web_session cookie. Xiaohongshu gates its signed APIs behind a logged-in session. Note Detail, User Profile, Channel Feed, and Mall Products need no login whatsoever. Search is login-walled and requires a web_session cookie from an XHS account you control; Note Comments (and User Notes beyond page 1) also rely on the signed API and are reliable only with the same web_session — guest access to those is now heavily throttled by XHS. See the FAQ for how to grab the cookie (30 seconds in your browser).

---

✨ Features

• 📕 Note Detail — title, desc, image list, video master URL + duration, like/save/comment/share counts (raw + numeric), creator, post & update timestamps, topic tags.
• 👤 User Profile — nickname, redId, gender, bio, IP location, fans / follows / interaction counts (raw + numeric), profession/college/location tags.
• 🧭 Channel Feed — cookieless topical discovery across 12 homefeed channels; returns note cards with title, likes, author, cover, and a ready-to-scrape URL + xsec_token. Paginate with maxPages (the feed rotates each load, so more pages = more unique notes); flip fullDetail on to hydrate every note to its full record.
• 🛍️ Mall Products — give a product URL or goods ID and get that shop's + related products, each with price, salePrice, officialPrice, couponPrice, soldCount, stockStatus, sellerId, vendorName, brand, imageUrl, and productUrl. Pure HTTP, no login.
• 📰 User Notes — a creator's published notes with per-note engagement and cover images; paginate with maxPages.
• 💬 Note Comments — top comments with content, author, IP location, like count, and a top-5 reply sample per thread.
• 🔍 Search Notes — keyword search with sort by comprehensive (综合), most popular (最热), or newest (最新).
• 🧑‍🤝‍🧑 Search Users — keyword search returning users/KOLs with fan counts.

---

🎯 Use cases

• Trend & content discovery (no login) — browse category feeds to see what's rising in beauty, fashion, food, travel, and more — without needing a keyword or an account.
• E-commerce & pricing research (no login) — track XHS mall product prices, discounts, units sold, and sellers for competitor and market analysis.
• KOL / influencer discovery — find creators by keyword, size them by fans and engagement.
• Brand & competitor monitoring — track a creator's catalog, a note's engagement, and comment sentiment.
• Content & campaign analytics — pull structured metrics for reporting instead of screenshotting the app.

---

⚙️ How it works

1. Pick an operation and paste the matching input — a note URL/ID, a user ID/URL, a channel, a product URL/goods ID, or a keyword.
2. The no-login operations read Xiaohongshu's server-rendered data (or the guest mall API) directly; the signed operations (comments, search) drive a real in-page signing step so requests are accepted.
3. Every result is normalized into one flat row per item and pushed to the dataset — filter by _operation to split modes.

---

📥 Input configuration

Field	Type	Notes
operation	select	One of the eight operations. Required.
noteId	string	Note ID or full note URL (Note Detail / Note Comments). Pasting the full URL also captures the xsec_token.
xsecToken	string	The note's xsec_token. Skip if you pasted the full note URL.
userId	string	User ID or full profile URL (User Profile / User Notes).
channel	select	Channel Feed category (Recommended, Fashion, Food, Beauty, Travel, Gaming…).
goodsId	string	Product URL (…/goods-detail/<id>) or 24-hex goods ID (Mall Products).
fullDetail	boolean	Channel Feed: hydrate each discovered note to full detail. Default off.
keyword	string	Search keyword, Chinese or English (Search Notes / Search Users).
searchSort	select	Search Notes ranking: comprehensive / most popular / newest.
maxPages	integer	Pages to fetch on paginated operations (~15–20 items/page). Default 1.
maxItems	integer	Hard cap on total rows. Optional.
webSession	string (secret)	Logged-in web_session cookie. Required for Search, needed for reliable Note Comments / User Notes pagination.
proxy	proxy	Defaults to built-in residential routing; override if needed.

Example input

{
  "operation": "mall-products",
  "goodsId": "https://www.xiaohongshu.com/goods-detail/6449fb26db9efc0001b1c665"
}

---

📤 Output

One flat row per item; filter on _operation to split modes.

Mall Products row (abridged):

{
  "_operation": "mall-products",
  "goodsId": "6449fb26db9efc0001b1c665",
  "title": "专利款：紫光檀无漆无蜡六齿头部经络按摩梳",
  "price": 89.9,
  "salePrice": 69.9,
  "currency": "CNY",
  "soldText": "已售3717",
  "soldCount": 3717,
  "stockStatus": 1,
  "sellerId": "63760151f3e1aa0001e68de9",
  "vendorName": "君匠的店",
  "imageUrl": "https://qimg.xiaohongshu.com/arkgoods/...",
  "productUrl": "https://www.xiaohongshu.com/goods-detail/6449fb26db9efc0001b1c665"
}

Note Detail row (abridged):

{
  "_operation": "note-detail",
  "noteId": "64ba392e000000000b0283ce",
  "noteType": "video",
  "noteTitle": "备婚系列🍒被问疯了的/敬酒妆容一比一复刻",
  "likedCount": "3.8万",
  "likedCountNum": 38000,
  "collectedCountNum": 9235,
  "commentCountNum": 212,
  "userName": "大魔王喵",
  "postedAt": "2023-07-21T07:52:14.000Z",
  "isVideo": true,
  "videoUrl": "https://sns-video-...xhscdn.com/stream/....mp4",
  "notePageUrl": "https://www.xiaohongshu.com/explore/64ba392e000000000b0283ce?xsec_token=..."
}

Key output fields

Field	Description
_operation	Which mode produced the row — filter on this to split modes.
noteId / userId / goodsId	Xiaohongshu 24-hex identifiers.
likedCount … shareCount	Human strings as shown on XHS ("1.8万"), each with a numeric …Num twin.
price / salePrice / soldCount	Mall product price, discounted price, and units sold (parsed from 已售…).
vendorName / sellerId	Mall seller/shop identity.
noteCoverUrl / imageUrls / videoUrl / imageUrl	Media URLs.
redId	The public Xiaohongshu ID on a profile.
notePageUrl / productUrl	Shareable note / product URLs.

---

❓ FAQ

Which operations need no login at all? Note Detail, User Profile, Channel Feed (category discovery), and Mall Products all run as a plain guest — no cookie, no account.

Why does Search need a web_session cookie? Xiaohongshu hard-blocks its search API for logged-out visitors (code -104, "no permission"). There is no guest path — providing a web_session from an account you control is the only way, the same requirement every XHS data source faces.

How do I get my web_session cookie? (~30 seconds)

1. Log in at xiaohongshu.com in your browser.
2. Open DevTools → Application (Chrome) / Storage (Firefox) → Cookies → https://www.xiaohongshu.com.
3. Copy the value of the web_session cookie and paste it into the webSession input.

Use an account you're comfortable running automation on. The cookie is stored as a secret input.

Do Note Comments and User Notes need the cookie too? Xiaohongshu now throttles guest access to its signed comment API aggressively, so Note Comments (and User Notes beyond page 1) are reliable only with a web_session. User Notes page 1 still renders login-free.

How does Channel Feed discovery differ from Search? Channel Feed browses Xiaohongshu's own category feeds (a topical stream), which works with no login. Search filters by an exact keyword, which XHS gates behind login. If you just need topical volume without an account, use Channel Feed.

Where do I find a note's xsec_token or a product's goods ID? The xsec_token is in the note URL you copy (…/explore/<id>?xsec_token=…) — paste the whole URL into noteId. The goods ID is the string in a product URL (…/goods-detail/<id>) — paste the whole URL into goodsId.

What proxy should I use? The actor ships with residential routing that works out of the box. You can override it with Apify Proxy or your own proxy URLs.

---

🛠️ Support

Found a bug or need a field added? Open an issue on the actor's Issues tab and we'll take a look.

---

🤖 For AI agents & LLM apps

This actor returns clean, flat JSON — one row per item, stable camelCase keys, and an _operation discriminator — so it drops straight into RAG pipelines, agent tools, and MCP servers. The no-login operations (Note Detail, User Profile, Channel Feed, Mall Products) need no credentials, making them ideal for autonomous agents that shouldn't manage cookies. Call it programmatically via the Apify API or as an MCP tool: pick an operation, pass the matching input, and consume the dataset.

---

⚠️ Disclaimer

This actor collects only publicly available information from Xiaohongshu and does not bypass authentication for content you couldn't otherwise view. You are responsible for how you use the scraped data, including compliance with Xiaohongshu's Terms of Service, applicable data-protection laws (e.g. GDPR/PIPL), and any rights in the underlying content. Do not use it to collect personal data unlawfully or to infringe intellectual-property rights. This actor is not affiliated with, endorsed by, or sponsored by Xiaohongshu / Xingin.

SEO Keywords

Xiaohongshu scraper, RedNote scraper, 小红书 scraper, XHS scraper, Little Red Book scraper, Xiaohongshu API, RedNote API, Xiaohongshu note scraper, Xiaohongshu user scraper, Xiaohongshu comments scraper, Xiaohongshu search scraper, Xiaohongshu product scraper, Xiaohongshu mall scraper, RedNote product scraper, Xiaohongshu price scraper, Xiaohongshu category feed, Xiaohongshu trend discovery, Xiaohongshu KOL discovery, RedNote influencer scraper, China social media scraper, China e-commerce scraper, Xiaohongshu data export, xhs note detail, xiaohongshu user profile, redbook scraper.