# RedNote Xiaohongshu (小红书) Scraper ✅ NO COOKIES (`atomus/xiaohongshu-scraper`) Actor

Turn RedNote (Xiaohongshu / 小红书) into clean JSON: notes, comments, profiles, products, trends and PGY influencer analytics, by keyword or URL. For AI corpora, consumer and brand research, and social listening. No cookies, no login on any mode; rivals need a session cookie. Failed lookups are free.

- **URL**: https://apify.com/atomus/xiaohongshu-scraper.md
- **Developed by:** [Atomus APIs](https://apify.com/atomus) (community)
- **Categories:** Social media, E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $16.00 / 1,000 note scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 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:

```json
{
  "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](https://apify.com/atomus/linkedin-profile-scraper)
- [LinkedIn Company Scraper](https://apify.com/atomus/linkedin-company-scraper)
- [LinkedIn Posts Scraper](https://apify.com/atomus/linkedin-posts-scraper-pro)
- [LinkedIn Reactions Scraper](https://apify.com/atomus/linkedin-reactions-scraper-pro)
- [LinkedIn Comments Scraper](https://apify.com/atomus/linkedin-comments-scraper-pro)

### 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` 免费缩小关键词搜索结果。

### 输出

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

```json
{
  "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](https://apify.com/atomus/linkedin-profile-scraper)
- [LinkedIn Company Scraper](https://apify.com/atomus/linkedin-company-scraper)
- [LinkedIn Posts Scraper](https://apify.com/atomus/linkedin-posts-scraper-pro)
- [LinkedIn Reactions Scraper](https://apify.com/atomus/linkedin-reactions-scraper-pro)
- [LinkedIn Comments Scraper](https://apify.com/atomus/linkedin-comments-scraper-pro)

### 常见问题

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

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

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

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

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

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

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

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

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

### 免责声明

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

# Actor input Schema

## `searchType` (type: `string`):

Choose the mode. 💲 Each mode is its own PAID event: the price is shown on every option below. Then fill ONLY the section marked with the same mode. // 选择模式。💲 每种模式为独立的付费事件，价格已标注在下方每个选项上；然后只填写标有相同模式的分区。

## `maxItems` (type: `integer`):

How many results to return per keyword or target for search, product search and trending. 💲 Affects cost: these bill per result, so a higher value costs more. Detail/profile/influencer return one record per target; comments use their own "Max comments per note" below. // 用于搜索、商品搜索与热榜，每个关键词或目标返回的最大结果数。💲 影响费用：按条计费，数值越大费用越高；详情/主页/达人每个目标一条记录；评论用下方「每条笔记最大评论数」。

## `noteType` (type: `string`):

Only for "Keyword search". FREE: restrict results to a note type, no extra charge. // 仅用于「关键词搜索」，免费，按笔记类型筛选，不额外计费。

## `timeFilter` (type: `string`):

Only for "Keyword search". FREE: restrict results by publish time, no extra charge. // 仅用于「关键词搜索」，免费，按发布时间筛选，不额外计费。

## `sortType` (type: `string`):

Only for "Keyword search". FREE: order the results. "Most liked" is the way to get the highest-engagement notes first. // 仅用于「关键词搜索」，免费，对结果排序。「最热」可优先获取高互动笔记。

## `keywords` (type: `array`):

💲 Paid per result of the selected mode: keyword search $0.02/note, product search $0.04/product. One or more terms, e.g. "护肤" (skincare), "口红" (lipstick). // 💲 按所选模式的结果计费：关键词搜索 $0.02/条，商品搜索 $0.04/个。可填写一个或多个关键词。

## `noteUrls` (type: `array`):

💲 Paid per selected mode: note detail $0.04/note, comments $0.01/comment (min 2 per note). Paste full note URLs (https://www.xiaohongshu.com/explore/...), app share links (http://xhslink.com/... - just paste as-is, resolved automatically), or bare 24-character note IDs. // 💲 按所选模式计费：笔记详情 $0.04/条，评论 $0.01/条（每条笔记最低2）。可粘贴完整笔记链接、App分享短链接（http://xhslink.com/... 直接粘贴即可，自动解析）或24位笔记ID。

## `maxComments` (type: `integer`):

For "Note comments" mode and the "Also fetch comments" add-on. 💲 Each comment returned is billed comment ($0.01, min 2 per note). // 用于「笔记评论」模式及「同时抓取评论」附加项。💲 每返回一条评论按 comment 计费（$0.01，每条笔记最低2）。

## `userUrls` (type: `array`):

💲 Paid per selected mode: profile $0.04/profile, influencer analytics $0.05/creator. Paste profile URLs (https://www.xiaohongshu.com/user/profile/...) or bare 24-character user IDs. // 💲 按所选模式计费：主页 $0.04/个，达人分析 $0.05/个。可粘贴主页链接或24位用户ID。

## `includePosts` (type: `boolean`):

For "User profile" only. 💲 PAID add-on: also returns the user's recent posts, billed as post-scraped ($0.02 per post returned) ON TOP of the $0.04 profile charge. Off by default. // 仅用于「用户主页」。💲 付费附加项——在 $0.04 主页费用之外，额外返回用户最近发布的笔记，按 post-scraped 计费（$0.02/条）。默认关闭。

## `maxPostsPerUser` (type: `integer`):

Only used when "Also fetch the user's posts" is on. 💲 Each post returned is billed post-scraped ($0.02). Set 0 to fetch none. // 仅在启用「同时抓取用户笔记」时生效。💲 每返回一条笔记按 post-scraped 计费（$0.02）。设为 0 则不抓取。

## `includeComments` (type: `boolean`):

For "Note detail" only. 💲 PAID add-on: also returns the note's comments, billed as comment ($0.01/comment, min 2 per note) ON TOP of the $0.04 note-detail charge. Use "Max comments per note" above to cap. Off by default. // 仅用于「笔记详情」。💲 付费附加项——在 $0.04 笔记详情费用之外，额外返回该笔记的评论，按 comment 计费（$0.01/条，每条笔记最低2）。用上方「每条笔记最大评论数」限制数量。默认关闭。

## Actor input object example

```json
{
  "searchType": "search",
  "maxItems": 20,
  "noteType": "不限",
  "timeFilter": "不限",
  "sortType": "general",
  "keywords": [
    "护肤"
  ],
  "maxComments": 20,
  "includePosts": false,
  "maxPostsPerUser": 20,
  "includeComments": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "护肤"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("atomus/xiaohongshu-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": ["护肤"] }

# Run the Actor and wait for it to finish
run = client.actor("atomus/xiaohongshu-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "护肤"
  ]
}' |
apify call atomus/xiaohongshu-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,atomus/xiaohongshu-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/hze9g9xvmpSRztttq/builds/ERcoLCOLIuuNtienV/openapi.json