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

• 🔓 Five operations run with no login at all — Note Detail, User Profile, Channel Feed (topical discovery), Mall Products (prices, sales, sellers), and Search Notes (keyword search) 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.

---

🎯 Just need one thing? Use the focused actors

This is the all-in-one actor — eight operations behind one input. If your workflow only needs a single operation, the dedicated actors are simpler to wire up (one-purpose input schema, same engine, same pricing):

• RedNote Search Scraper — keyword → notes, no login
• RedNote Comments Scraper — full comment threads with nested-reply samples
• RedNote Note Detail Scraper — one note's full data, no login
• RedNote User Profile Scraper — bio, follower counts, red ID, no login
• RedNote User Posts Scraper — a creator's note catalog
• RedNote Trending Scraper — 12 category feeds, no login
• RedNote Product Scraper — mall prices, sales, sellers, no login

Stay here if you mix operations in one pipeline, or need user search — the one operation without its own actor.

---

📋 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	Preview free (no note IDs); IDs + pages need cookie*
💬 Note Comments	top comments with author, IP location, likes + a reply sample	Preview free; full thread needs cookie*
🔍 Search Notes	keyword → notes with text, counts, tags, publish time and author ID	No
🧑‍🤝‍🧑 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, Mall Products, and Search Notes need no login whatsoever. Search Users is login-walled and requires a web_session cookie from an XHS account you control; for Search Notes a cookie only switches to the logged-in search, which applies the sort option. Note Comments without a cookie returns a preview: the first batch Xiaohongshu shows a guest, about 5 top-level comments with up to 3 replies each, rows marked accessMode: "preview"; with a cookie it paginates the full thread. User Notes without a cookie is a preview with blank note IDs (Xiaohongshu hides them from guests since September 2026); IDs and pagination need a cookie.

---

✨ 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. When Xiaohongshu won't render a category for a logged-out visitor (frequent since September 2026), the rows come from keyword search on the category's name instead; those rows carry origin: "keyword-search", feed rows origin: "feed".
• 🛍️ 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 no login: note ID, title, text, likes/saves/comments/shares, tags, publish time, and the author's user ID. With a web_session, the logged-in search applies 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 pages or its guest-facing APIs directly; the logged-in operations (full comment threads, user search, logged-in note 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. Applied by the logged-in search (needs a web_session).
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 Users; optional for Search Notes (switches to the logged-in search, which applies sort); turns Note Comments from a ~5-comment preview into the full thread; needed for User Notes IDs and 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), Mall Products, and Search Notes (keyword search) all run as a plain guest — no cookie, no account.

What do Note Comments return without a cookie? A preview: the first batch Xiaohongshu shows a guest, about 5 top-level comments with up to 3 replies each, marked accessMode: "preview". Every comment API answers a login wall to a guest, so the full paginated thread needs a web_session.

Does Search need a web_session cookie? Search Notes does not: keyword search returns notes, including the author's user ID, with no login. Search Users does: Xiaohongshu hard-blocks user search for logged-out visitors (code -104, "no permission"), so it needs a web_session from an account you control. For Search Notes a cookie only switches to the logged-in search, which applies the sort option.

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 category feeds (a topical stream); Search Notes filters by the keyword you give it. Both run with no login. Use Channel Feed for what's surfacing in a category, Search Notes for a specific topic, product, or brand.

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, Search Notes) 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.