RedNote Xiaohongshu (小红书) Scraper All-in-One

RedNote (Xiaohongshu / 小红书) is where hundreds of millions of Chinese shoppers post first-person product reviews, hauls, and purchase decisions before they buy. This actor turns that into clean, structured JSON for AI training corpora, China consumer and brand research, social listening, and influencer (蒲公英/PGY) analytics. Give it a keyword or a plain URL and get results back in seconds.

No cookies, no login, no xsec_token, on every mode. Most Xiaohongshu scrapers make you paste a logged-in session cookie first, and some require it even for keyword search and note detail. This one never asks for one, and it returns the xsec_token for every note so you can chain results straight into downstream steps.

It is API-based, not a headless browser, so runs are fast (most requests return in about 1 to 2 seconds) with no captchas or page loads to wait on. Seven modes cover search, note and video detail, comments, profiles, products, the trending hot list, and influencer rate cards; each is a paid event with its price shown up front, and failed lookups are free.

What is RedNote (Xiaohongshu)?

Xiaohongshu (小红书), known internationally as RED or RedNote, is one of China's largest social and e-commerce platforms, with hundreds of millions of users. People post "notes" (笔记): image and video reviews, hauls, guides, and recommendations, then discover products and creators through search and the trending hot list. Its first-person product opinions and influencer (蒲公英/PGY) marketplace make it a key source for social listening, market research, and influencer marketing in China.

What data can you extract from RedNote (Xiaohongshu)?

Pick a mode with the What to scrape dropdown. Each mode is billed as its own event, and failed lookups are free.

Mode (searchType)	Input	Returns
Keyword search (search)	keyword(s)	Notes matching a keyword
Note detail (note-detail)	note URL(s) or ID(s)	Full detail for one note (image or video)
User profile (profile)	profile URL(s) or user ID(s)	A user's profile, optionally with their posts
Note comments (comments)	note URL(s) or ID(s)	Comments on a note
Product search (products)	keyword(s)	Products from RED's store search
Trending (trending)	none	The RED hot list
Influencer analytics (influencer)	profile URL(s) or user ID(s)	蒲公英/PGY rate card and analytics

Each note comes back as one structured record:

Field	Description
id	Note ID
type	normal (image) or video
title, desc	Note title and body text
url	Public note link (includes xsec_token when available)
liked_count, collected_count, comments_count, shared_count	Engagement counts
view_count	View count (on note detail)
images	Image URLs
video_url, cover	Playable video URL and cover (video notes)
hashtags, topics	Hashtags and topics
ip_location	Poster's IP region
timestamp	Publish time
xsec_token	Access token returned with search results
user	Author: user_id, red_id, nickname, avatar, verified

Other modes return their own records: comments (text, likes, author, reply count, IP region), profiles (nickname, RED ID, bio, fans, follows, note count, verification), products (title, price, vendor, image, link), trending topics (rank, topic, hot value), and influencer records (picture/video rate card, fans count, level, content tags, 30-day growth, core data and fans summary).

How do I scrape RedNote (Xiaohongshu)?

1. Choose a mode in What to scrape.
2. Provide its input: keyword(s) for search and products, note URL(s) or ID(s) for note detail and comments, profile URL(s) or user ID(s) for profile and influencer. Trending needs no input.
3. Set Max results for the paginated modes (search, comments, products, trending).
4. Run the actor. Results appear in the dataset, ready to fetch via the Apify API.

Input

Field	Used by	Description
searchType	all	The mode to run (see the table above). Default search
keywords	search, products	One or more search terms, e.g. 护肤, 口红
noteUrls	note-detail, comments	Note URLs, share links, or bare 24-character note IDs
userUrls	profile, influencer	Profile URLs or bare 24-character user IDs
maxItems	search, products, trending	How many results per keyword/target (default 20)
maxComments	comments, note-detail add-on	Max comments per note (default 20)
noteType	search	Filter by note type: any, video, image, live
timeFilter	search	Filter by publish time: any, last day, last week, last 6 months
includePosts	profile	Also fetch the user's posts (paid add-on, see pricing)
maxPostsPerUser	profile	How many posts to fetch when includePosts is on
includeComments	note-detail	Also fetch the note's comments (paid add-on, see pricing)

Supported URL formats:

• Note: https://www.xiaohongshu.com/explore/<noteId>, an app share link (http://xhslink.com/..., resolved automatically), or the bare 24-character note ID.
• Profile: https://www.xiaohongshu.com/user/profile/<userId>, or the bare 24-character user ID.

Free filters

noteType and timeFilter narrow keyword-search results at no extra cost.

Output

Each result is one record in the dataset. A note looks like this:

{
  "searchType": "search",
  "keyword": "护肤",
  "id": "69848696000000001a0272ba",
  "type": "normal",
  "title": "分享年度护肤爱用（上）",
  "desc": "无广纯绿，放心看！ #种草 #好物分享",
  "url": "https://www.xiaohongshu.com/explore/69848696000000001a0272ba?xsec_token=...",
  "liked_count": 641,
  "collected_count": 265,
  "comments_count": 21,
  "shared_count": 27,
  "images": ["https://sns-webpic.xhscdn.com/..."],
  "video_url": null,
  "hashtags": ["种草", "好物分享"],
  "topics": [],
  "ip_location": "Shanghai",
  "timestamp": 1770292886,
  "xsec_token": "YBd5BH-4wMfkhVF6rX6T3Zo4Q1Om9EymkzCvikehzjSIw=",
  "user": { "user_id": "617175e1000000000201d2b9", "red_id": "5346064794", "nickname": "飞侠桃", "avatar": "https://sns-avatar-qc.xhscdn.com/...", "verified": false }
}

How much does it cost to scrape RedNote (Xiaohongshu)?

Pay per event, per mode, with no subscription. Gold and higher Apify plans get 20% off:

Mode	Event	Price (per result)	Gold price
Keyword search	post-scraped	$0.02	$0.016
Note detail (image)	post-detail	$0.04	$0.032
Note detail (video)	video	$0.04	$0.032
User profile	profile	$0.04	$0.032
Comment	comment	$0.01 (min 2 per note)	$0.008
Product	product	$0.04	$0.032
Trending topic	trend	$0.01 (min 2 per run)	$0.008
Influencer analytics	influencer	$0.05	$0.040

A keyword search returning 25 notes costs 25 x $0.02 = $0.50. A failed lookup is free (an unreachable or errored request is never charged). A request that succeeds is billed at least its per-item minimum, even if it comes back thin: the minimums on comments and trending, and the single-item floor on a note that turns out empty or deleted, cover the provider request.

Paid add-ons

• Also fetch the user's posts (profile mode). Returns the user's recent notes alongside the profile, billed as post-scraped ($0.02 per note). Off by default.
• Also fetch the note's comments (note-detail mode). Returns the note's comments alongside the detail, billed as comment ($0.01 per comment, min 2 per note), capped by "Max comments per note". Off by default. Prefer the standalone comments mode if you want comments only (no $0.04 note-detail charge).

Influencer mode always returns the full analytics (rate card + core data + fans summary) for the single $0.05 charge: there is no separate toggle or extra cost.

Limits and how it handles them

• Pagination is automatic up to your Max results: search 20 per page, comments 10 per page, products 20 per page. Results are de-duplicated across pages so you are never billed for a repeated item.
• Influencer analytics needs a 蒲公英/PGY-registered creator. A user not registered on PGY returns no influencer record; when the lookup comes back as an error it is not charged.
• Video note detail returns the playable video URL; image and video notes are billed at the same $0.04.
• Media URLs are on Xiaohongshu's CDN and can expire after a while (hours to days). Download the images and videos you need soon after the run rather than storing the URLs long-term.
• Search coverage per keyword is finite. Xiaohongshu returns a bounded set of results per keyword, so a very high Max results on a narrow keyword returns what exists, not more.

Use it with AI agents and MCP

Like any Apify actor, RedNote Xiaohongshu Scraper can be called from the Apify API and used as a tool by AI agents and MCP clients. An agent can run it to pull fresh Xiaohongshu data on demand, then feed the structured records straight into its workflow.

Use cases

• Social listening and trends. Track what is trending on RED, monitor hashtags and topics, and watch how a keyword performs over time.
• Influencer marketing. Pull a creator's PGY rate card, fans count, and 30-day growth to shortlist and price collaborations.
• E-commerce and product research. Search products, read prices and vendors, and measure demand around a keyword.
• Competitor and content research. Scrape a competitor's profile and posts, and read comments to understand audience sentiment.

RedNote Xiaohongshu Scraper vs cookie-based tools vs the official API

	RedNote Xiaohongshu Scraper	Browser or cookie tools	Official API
Setup	Keyword or URL, run	Paste a logged-in cookie or xsec_token	No public content API for most of this data
Login required	No	Yes, a logged-in session	Not applicable
Coverage	Notes, comments, profiles, products, trending, PGY analytics	Usually one surface at a time	Limited
Cost model	Pay per event, failed lookups free	Your time and account risk	Not applicable
Maintenance	None	Breaks when the site or cookie changes	Not applicable

Other scrapers by Atomus

Public actors you can pair with this one:

• LinkedIn Profile Scraper
• LinkedIn Company Scraper
• LinkedIn Posts Scraper
• LinkedIn Reactions Scraper
• LinkedIn Comments Scraper

FAQ

Is there an official Xiaohongshu (RedNote) API? There is no public content API that covers notes, comments, profiles, products, trending, and influencer data. This actor gives you that data with a simple keyword or URL and per-result pricing.

Do I need a cookie or login? No. A keyword or a plain URL is enough. There is no cookieString and no xsec_token to paste.

Is it legal to scrape Xiaohongshu? The actor collects only publicly available data. You are responsible for how you use it and for complying with applicable laws and terms.

How many results can I get? As many as you set in Max results for the paginated modes; the actor paginates automatically and de-duplicates across pages. Xiaohongshu returns a finite set per keyword, so a narrow keyword returns what exists.

How fast is it? Most requests return in about 1-2 seconds. It is API-based (no headless browser), so there are no captchas or page loads, and large searches paginate automatically up to your Max results.

Can I search in Chinese and English? Yes. Use Chinese keywords (e.g. 护肤, 口红) for the best coverage, and English or brand keywords (e.g. lululemon) also work.

Does it work for video notes? Yes. Note detail returns the playable video URL and cover for video notes, and keyword search can be filtered to video notes only.

What is the difference between the modes? Use search to find notes by keyword, note detail for one note's full data, profile for a user, comments for a note's comments, products for shopping results, trending for the hot list, and influencer for a creator's 蒲公英/PGY rate card and analytics.

Can I run it on a schedule? Yes. Use Apify Schedules to run any mode on a recurring basis, for example to monitor a keyword or a competitor daily.

Disclaimer

This actor extracts publicly available data from Xiaohongshu (小红书 / RED / RedNote). Use it in compliance with applicable laws and the terms of the services involved. It is not affiliated with or endorsed by Xiaohongshu.

---

---

小红书 (RedNote / Xiaohongshu / RED) 采集器

小红书（RED / RedNote）是数亿中国消费者在购买前发布第一手商品测评、开箱与购买决策的平台。本采集器将其转化为干净的结构化 JSON，服务于 AI 训练语料、中国消费与品牌研究、社媒聆听，以及达人（蒲公英/PGY）分析。只需提供关键词或普通链接，秒级返回结果。

无需 Cookie、无需登录、无需粘贴 xsec_token，所有模式都不需要。 大多数小红书采集器要求先粘贴登录 Cookie，有些甚至连关键词搜索和笔记详情都要 Cookie。本采集器从不需要，还会为每条笔记返回 xsec_token，方便下游步骤直接串联使用。

基于 API 而非无头浏览器，运行快（多数请求约 1 至 2 秒返回），无需等待页面加载，也没有验证码。七种模式涵盖搜索、笔记与视频详情、评论、主页、商品、热榜与达人报价；每种模式为独立付费事件，价格预先标明，失败查询免费。

什么是小红书（RedNote / Xiaohongshu）？

小红书（国际上称 RED / RedNote）是中国最大的社交电商平台之一，拥有数亿用户。用户发布「笔记」：图文与视频测评、开箱、攻略与推荐，并通过搜索与热榜发现商品和创作者。其第一手的商品口碑与达人（蒲公英/PGY）营销市场，使其成为中国社媒聆听、市场研究与达人营销的关键数据来源。

可以采集哪些小红书数据？

用「抓取模式」下拉框选择模式，每种模式按各自事件计费，只为结果付费。

模式（searchType）	输入	返回
关键词搜索（search）	关键词	匹配关键词的笔记
笔记详情（note-detail）	笔记链接或ID	单条笔记完整详情（图文或视频）
用户主页（profile）	主页链接或用户ID	用户主页，可选其笔记
笔记评论（comments）	笔记链接或ID	笔记评论
商品搜索（products）	关键词	小红书商城搜索结果
热榜（trending）	无	小红书热榜
达人分析（influencer）	主页链接或用户ID	蒲公英/PGY 报价与分析数据

每条笔记返回一条结构化记录：

字段	说明
id	笔记ID
type	normal（图文）或 video（视频）
title、desc	标题与正文
url	公开笔记链接（可含 xsec_token）
liked_count、collected_count、comments_count、shared_count	互动数据
view_count	浏览量（笔记详情）
images	图片链接
video_url、cover	可播放视频地址与封面（视频笔记）
hashtags、topics	话题标签与话题
ip_location	发布者IP归属地
timestamp	发布时间
xsec_token	搜索结果返回的访问令牌
user	作者：user_id、red_id、nickname、avatar、verified

其他模式返回各自的记录：评论（内容、点赞、作者、回复数、IP归属地）、主页（昵称、小红书号、简介、粉丝、关注、笔记数、认证）、商品（标题、价格、店铺、图片、链接）、热榜话题（排名、话题、热度值），以及达人记录（图文/视频报价、粉丝数、等级、内容标签、30天涨粉、核心数据与粉丝画像）。

如何采集小红书？

1. 在「抓取模式」中选择模式。
2. 填写对应输入：搜索与商品用关键词；笔记详情与评论用笔记链接或ID；主页与达人用主页链接或用户ID；热榜无需输入。
3. 为分页模式（搜索、评论、商品、热榜）设置最大结果数。
4. 运行 Actor，结果写入数据集，可通过 Apify API 获取。

输入

字段	适用模式	说明
searchType	全部	运行的模式（见上表）。默认 search
keywords	search、products	一个或多个关键词，如 护肤、口红
noteUrls	note-detail、comments	笔记链接、分享链接或24位笔记ID
userUrls	profile、influencer	主页链接或24位用户ID
maxItems	search、products、trending	每个关键词/目标的结果数（默认20）
maxComments	comments、note-detail 附加项	每条笔记的最大评论数（默认20）
noteType	search	按笔记类型筛选：不限、视频、图文、直播
timeFilter	search	按发布时间筛选：不限、一天内、一周内、半年内
includePosts	profile	额外抓取用户笔记（付费附加项，见计费）
maxPostsPerUser	profile	启用 includePosts 时抓取的笔记数
includeComments	note-detail	额外抓取笔记评论（付费附加项，见计费）

支持的链接格式：

• 笔记：https://www.xiaohongshu.com/explore/<noteId>、App分享短链接（http://xhslink.com/...，自动解析），或24位笔记ID。
• 主页：https://www.xiaohongshu.com/user/profile/<userId>，或24位用户ID。

免费筛选

noteType 与 timeFilter 免费缩小关键词搜索结果。

输出

每条结果为数据集中的一条记录。笔记示例：

{
  "searchType": "search",
  "keyword": "护肤",
  "id": "69848696000000001a0272ba",
  "type": "normal",
  "title": "分享年度护肤爱用（上）",
  "liked_count": 641,
  "collected_count": 265,
  "comments_count": 21,
  "ip_location": "Shanghai",
  "xsec_token": "YBd5BH-4wMfkhVF6rX6T3Zo4Q1Om9EymkzCvikehzjSIw=",
  "user": { "user_id": "617175e1000000000201d2b9", "red_id": "5346064794", "nickname": "飞侠桃", "verified": false }
}

采集小红书的费用是多少？

按结果计费，无订阅。Gold 及以上 Apify 套餐享 8 折：

模式	事件	单价（每条结果）	Gold 价
关键词搜索	post-scraped	$0.02	$0.016
笔记详情（图文）	post-detail	$0.04	$0.032
笔记详情（视频）	video	$0.04	$0.032
用户主页	profile	$0.04	$0.032
评论	comment	$0.01（每条笔记最低2）	$0.008
商品	product	$0.04	$0.032
热榜话题	trend	$0.01（每次运行最低2）	$0.008
达人分析	influencer	$0.05	$0.040

搜索返回25条笔记 = 25 × $0.02 = $0.50。失败查询免费（请求出错或无法连接时不计费）。请求成功即按最低计费，即使返回内容很少——评论与热榜的每次最低计费，以及笔记为空或已删除时的单条保底，都用于覆盖上游请求成本。

付费附加项

• 同时抓取用户笔记（主页模式）：在主页基础上返回用户最近笔记，按 post-scraped（$0.02/条）计费。默认关闭。
• 同时抓取笔记评论（笔记详情模式）：在笔记详情基础上返回该笔记的评论，按 comment（$0.01/条，每条笔记最低2）计费，由「每条笔记最大评论数」限制。默认关闭。若只需要评论，请用独立的 comments 模式（不含 $0.04 笔记详情费用）。

达人模式始终返回完整分析（报价卡 + 核心数据 + 粉丝画像），按一条 $0.05 记录计费——没有单独开关，也无额外费用。

限制与处理方式

• 自动翻页至你的最大结果数：搜索每页20条、评论每页10条、商品每页20条。跨页去重，重复项不计费。
• 达人分析需为蒲公英/PGY 注册创作者。 未入驻蒲公英的用户不返回 influencer 记录；当查询以错误返回时不计费。
• 视频笔记详情返回可播放视频地址；图文与视频笔记同价 $0.04。
• 媒体链接来自小红书 CDN，可能会过期（数小时到数天）。请在运行后尽快下载所需图片和视频，不要长期保存链接。
• 每个关键词的搜索覆盖有限。 小红书对每个关键词返回的结果有上限，因此在窄关键词上设置过高的最大结果数只会返回实际存在的数量。

与 AI 智能体和 MCP 一起使用

与任何 Apify actor 一样，本采集器可通过 Apify API 调用，并作为工具供 AI 智能体和 MCP 客户端使用。智能体可按需拉取小红书数据，直接接入工作流。

使用场景

• 社媒聆听与趋势。 追踪小红书热点，监控话题标签，观察关键词表现。
• 达人营销。 获取创作者的蒲公英报价、粉丝数与30天涨粉，用于筛选与定价合作。
• 电商与商品研究。 搜索商品、读取价格与店铺，衡量关键词需求。
• 竞品与内容研究。 抓取竞品主页与笔记，读取评论了解受众情绪。

小红书采集器 vs Cookie 工具 vs 官方 API

	小红书采集器	浏览器/Cookie 工具	官方 API
配置	关键词或链接，运行	粘贴登录 Cookie 或 xsec_token	多数数据无公开内容 API
是否需登录	否	是，需登录会话	不适用
覆盖范围	笔记、评论、主页、商品、热榜、蒲公英分析	通常一次一个入口	有限
计费模式	按事件计费，失败查询免费	你的时间与账号风险	不适用
维护	无	站点或 Cookie 变化即失效	不适用

Atomus 的其他采集器

可与本采集器搭配使用的公开 actor：

• LinkedIn Profile Scraper
• LinkedIn Company Scraper
• LinkedIn Posts Scraper
• LinkedIn Reactions Scraper
• LinkedIn Comments Scraper

常见问题

小红书有官方 API 吗？ 没有覆盖笔记、评论、主页、商品、热榜与达人数据的公开内容 API。本采集器用简单的关键词或链接提供这些数据，并按结果计费。

需要 Cookie 或登录吗？ 不需要。关键词或普通链接即可，无需 cookieString，无需 xsec_token。

采集小红书合法吗？ 本采集器仅采集公开数据。使用方式由你自行负责，并需遵守适用法律与条款。

能获取多少结果？ 分页模式下由最大结果数决定；采集器自动翻页并跨页去重。小红书对每个关键词返回的结果有限，窄关键词返回实际存在的数量。

速度如何？ 多数请求约 1-2 秒返回。基于 API（非无头浏览器），无验证码、无页面加载，大批量搜索会自动翻页至你的最大结果数。

支持中英文搜索吗？ 支持。中文关键词（如 护肤、口红）覆盖最佳，英文或品牌关键词（如 lululemon）也可用。

支持视频笔记吗？ 支持。笔记详情返回视频笔记的可播放视频地址与封面，关键词搜索也可只筛选视频笔记。

各模式有什么区别？ search 按关键词找笔记，note detail 获取单条笔记完整数据，profile 获取用户，comments 获取笔记评论，products 获取商品，trending 获取热榜，influencer 获取创作者的蒲公英/PGY 报价与分析。

可以定时运行吗？ 可以。用 Apify Schedules 定时运行任意模式，例如每日监控某个关键词或竞品。

免责声明

本采集器提取小红书（小红书 / RED / RedNote）的公开数据。请在遵守适用法律与相关服务条款的前提下使用。本采集器与小红书无关联，也未获其背书。