RedNote (Xiaohongshu) Scraper

Pull RedNote (Xiaohongshu) posts, profiles, comments, products, topics, and feeds from one Actor. Give it a post link, a profile link, a keyword, or a product ID, and it returns structured rows — titles, captions, like/comment/save counts, author details, prices, and review scores. No login or session cookie required: the fields a session would carry — xsec_token, cookie, session — are stripped from input before a request is ever built, not merely left unused.

Modes

Set scraperType to pick what this run collects. Each mode takes its own identifier below the picker.

Mode	Returns	Needs	Or use the focused Actor
Post details	One image or video post's full record	post_id_or_url and content_type	RedNote Post Scraper
Post comments	A post's comments, with optional nested replies	post_id_or_url	RedNote Comments Scraper
Profile details	One profile's public data	profile_id_or_url	RedNote Profile Scraper
Profile posts	Every public post on a profile	profile_id_or_url	RedNote Profile Posts Scraper
Profile favorites	A profile's publicly visible saved posts	profile_id_or_url	RedNote Favorites Scraper
Search posts	Posts matching a keyword	query	RedNote Search Scraper
Search profiles	Profiles matching a keyword	query	RedNote Profile Search Scraper
Search images	Image-only posts matching a keyword	query	RedNote Image Search Scraper
Search products	Product listings matching a keyword	query	RedNote Product Search Scraper
Search groups	Interest groups matching a keyword	query	RedNote Group Search Scraper
Topic details	One topic's public metadata	topic_id	RedNote Topic Scraper
Topic notes	Posts tagged with a topic	topic_id	RedNote Topic Scraper
Product details	One product's raw detail record	product_id	RedNote Product Scraper
Product review overview	A product's average score and review count	product_id	RedNote Product Reviews Scraper
Product reviews	Every individual review for a product	product_id	RedNote Product Reviews Scraper
Product recommendations	Products RedNote recommends alongside one product	product_id	RedNote Product Recommendations Scraper
Creator inspiration	Content-idea prompts for creators	none	RedNote Creator Inspiration Scraper
Hot creator inspiration	Currently trending content-idea prompts	none	RedNote Creator Inspiration Scraper
Home feed	The public RedNote home feed	none	RedNote Home Feed Scraper
Hot trends	The current hot-topics list	none	RedNote Hot Trends Scraper

scraperType is the only field this Actor marks required. Every other field is mode-specific, and most identifier fields raise a plain error when they're missing rather than an empty run — Provide a public post URL or post ID, Provide a public profile URL or profile ID, Provide a search query, Provide a topic ID, Provide a product ID. Post Details additionally requires content_type on top of the post identifier, and stops with Choose whether the post is an image post or video post if it's left unset — there's no default, because the two content types hit different endpoints.

One Actor or sixteen?

The twenty modes above are also sold as sixteen focused Actors (a few pair two closely related modes, like Topic Details and Topic Notes, behind one Actor). Reach for a focused Actor once you know exactly which dataset you're pulling at scale — a post's comment tree, one profile's posts, product reviews for one listing. Reach for this Actor when a research project spans several of those — a topic's metadata plus its posts plus each poster's profile, say — because that's one Actor integration instead of switching between several.

Input

{
  "scraperType": "postDetails",
  "post_id_or_url": "https://www.xiaohongshu.com/explore/64f...",
  "content_type": "image"
}

post_id_or_url and profile_id_or_url both accept a bare ID or a page URL. topic_id and product_id do not — RedNote's topic and product pages carry a URL that doesn't resolve to the ID directly, so both modes need the ID itself. maxItems (default 100, 0 for no limit) caps every paginated mode; Post Details, Profile Details, Topic Details, Product Details, and Product Review Overview each return a single record instead.

Output

Field names vary by mode. Across the twenty, the ones you'll see most are:

Field	Contents
id, title, desc, type	Post identifiers, title, and content type
user	Author record
liked_count, comments_count, share_count, collected_count	Post engagement
red_id, nickname, fans, follows	Profile data
content, like_count, time	Comment data
avgScore, total, reviewId, itemScore	Product review data
price_info, vendor, stock_status	Product listing data
rank, hot, hot_value, trend	Hot-topics data

{
  "id": "64f8a2b1000000001203abcd",
  "title": "Weekend recipe idea",
  "desc": "Simple pasta dish for two",
  "type": "normal",
  "user": { "nickname": "creator123", "userid": "5f3a..." },
  "liked_count": "1.2k",
  "comments_count": "89"
}

Questions

I ran Profile Favorites on a public profile and got zero rows. Is that broken? No. RedNote keeps favorites private by default, and every public profile checked while building this Actor returned an empty favorites list regardless of how active or public the account otherwise was. A profile with a public favorites tab will return rows; most don't have one. An empty run here is the platform's own visibility setting, not a failed request.

Can I paste a topic or product page URL into topic_id or product_id? No — unlike post_id_or_url and profile_id_or_url, these two fields need the bare ID, not the page link. RedNote's topic and product URLs don't resolve back to the ID the way post and profile URLs do.

Product Details returns one big module field instead of separate price and title columns. Why? That mode intentionally ships the raw card/module tree rather than flattened fields — the real product data (title, price, images) lives inside per-card blocks whose structure varies by card type, and not every variant has been verified against a live response. Use Search Products or Product Recommendations for pre-flattened title/price columns; use Product Details when you need the full raw structure.

What's the difference between Product Review Overview and Product Reviews? Overview returns one summary record — average score, total review count, purchase-history count — and nothing else; the individual review sample RedNote's own overview endpoint bundles alongside those stats is deliberately dropped, because it's a partial, unflattened sample of the same reviews Product Reviews paginates properly. Use Product Reviews when you need the actual review text and ratings.

Does Hot Trends support a region filter? No. The region field exists in this Actor's shared schema for other modes, but Hot Trends doesn't use it — the request is unparameterized beyond pagination.

Do the add-ons (addonPostDetails, addonProfileDetails, addonProductDetails) always add a billed request? Only when they return something. Profile Posts, Search Profiles, and Search Products each apply their add-on as a follow-up request per row; a failed or empty follow-up leaves the original row in place, unbilled, rather than dropping it.

Is a RedNote login or session cookie ever required? No. Session-specific fields — xsec_token, xsec_source, cookie, session — are stripped from every request before it's built, across all twenty modes.

Related Actors

Actor	Purpose
RedNote Post Scraper	One post's full record
RedNote Comments Scraper	One post's comments
RedNote Profile Scraper	One profile's public data
RedNote Search Scraper	Keyword search across posts
RedNote Product Reviews Scraper	One product's review summary and full review list