# 小红书 API

21 个接口读小红书：笔记、图片、话题、用户、评论、热榜、蒲公英、小红书商城。一次 $0.0200 起。不用登录小红书，不用 Cookie；失败不收费。

也叫：Xiaohongshu (RedNote)、小红薯

近 30 天可用 99.9%：接口在接调用的时间占比

## 接口

### 笔记 (3)

| 接口 | 请求 | 返回 | 价格 |
| --- | --- | --- | --- |
| [小红书笔记搜索](https://dataxapi.com/zh/apis/xiaohongshu/notes/search.md) | `GET /v1/xiaohongshu/notes/search` | 内容列表 | $0.0200 / 次 |
| [小红书笔记详情](https://dataxapi.com/zh/apis/xiaohongshu/notes/get.md) | `GET /v1/xiaohongshu/notes/get` | 内容 | $0.0200 / 次 |
| [小红书笔记评论](https://dataxapi.com/zh/apis/xiaohongshu/notes/comments/list.md) | `GET /v1/xiaohongshu/notes/comments/list` | 评论列表 | $0.0200 / 次 |

### 图片 (1)

| 接口 | 请求 | 返回 | 价格 |
| --- | --- | --- | --- |
| [小红书图片搜索](https://dataxapi.com/zh/apis/xiaohongshu/images/search.md) | `GET /v1/xiaohongshu/images/search` | 内容列表 | $0.0200 / 次 |

### 话题 (2)

| 接口 | 请求 | 返回 | 价格 |
| --- | --- | --- | --- |
| [小红书话题详情](https://dataxapi.com/zh/apis/xiaohongshu/topics/get.md) | `GET /v1/xiaohongshu/topics/get` | 话题 | $0.0200 / 次 |
| [小红书话题笔记](https://dataxapi.com/zh/apis/xiaohongshu/topics/notes/list.md) | `GET /v1/xiaohongshu/topics/notes/list` | 内容列表 | $0.0200 / 次 |

### 用户 (3)

| 接口 | 请求 | 返回 | 价格 |
| --- | --- | --- | --- |
| [小红书用户搜索](https://dataxapi.com/zh/apis/xiaohongshu/users/search.md) | `GET /v1/xiaohongshu/users/search` | 账号列表 | $0.0200 / 次 |
| [小红书用户资料](https://dataxapi.com/zh/apis/xiaohongshu/users/get.md) | `GET /v1/xiaohongshu/users/get` | 账号 | $0.0200 / 次 |
| [小红书用户笔记](https://dataxapi.com/zh/apis/xiaohongshu/users/notes/list.md) | `GET /v1/xiaohongshu/users/notes/list` | 内容列表 | $0.0200 / 次 |

### 评论 (1)

| 接口 | 请求 | 返回 | 价格 |
| --- | --- | --- | --- |
| [小红书评论回复](https://dataxapi.com/zh/apis/xiaohongshu/comments/replies/list.md) | `GET /v1/xiaohongshu/comments/replies/list` | 评论列表 | $0.0200 / 次 |

### 热榜 (1)

| 接口 | 请求 | 返回 | 价格 |
| --- | --- | --- | --- |
| [小红书热点](https://dataxapi.com/zh/apis/xiaohongshu/trends/list.md) | `GET /v1/xiaohongshu/trends/list` | 热点列表 | $0.0200 / 次 |

### [蒲公英](https://dataxapi.com/zh/apis/xiaohongshu/pgy.md) (7)

小红书官方的博主合作平台：博主搜索、报价、粉丝画像和数据表现，以及关键词搜索指数。

| 接口 | 请求 | 返回 | 价格 |
| --- | --- | --- | --- |
| [小红书蒲公英博主搜索](https://dataxapi.com/zh/apis/xiaohongshu/pgy/creators/search.md) | `GET /v1/xiaohongshu/pgy/creators/search` | 达人列表 | $0.0400 / 次 |
| [小红书蒲公英博主粉丝画像](https://dataxapi.com/zh/apis/xiaohongshu/pgy/creators/audience/get.md) | `GET /v1/xiaohongshu/pgy/creators/audience/get` | 粉丝画像 | $0.0400 / 次 |
| [小红书蒲公英博主详情](https://dataxapi.com/zh/apis/xiaohongshu/pgy/creators/get.md) | `GET /v1/xiaohongshu/pgy/creators/get` | 达人 | $0.0400 / 次 |
| [小红书蒲公英博主数据表现](https://dataxapi.com/zh/apis/xiaohongshu/pgy/creators/metrics.md) | `GET /v1/xiaohongshu/pgy/creators/metrics` | 蒲公英博主数据表现 | $0.0400 / 次 |
| [小红书蒲公英博主笔记](https://dataxapi.com/zh/apis/xiaohongshu/pgy/creators/notes/list.md) | `GET /v1/xiaohongshu/pgy/creators/notes/list` | 蒲公英博主笔记列表 | $0.0400 / 次 |
| [小红书蒲公英关键词逐日搜索指数](https://dataxapi.com/zh/apis/xiaohongshu/pgy/keywords/history.md) | `GET /v1/xiaohongshu/pgy/keywords/history` | 关键词指数历史 | $0.0400 / 次 |
| [小红书蒲公英关联词](https://dataxapi.com/zh/apis/xiaohongshu/pgy/keywords/related.md) | `GET /v1/xiaohongshu/pgy/keywords/related` | 关联词列表 | $0.0400 / 次 |

### [小红书商城](https://dataxapi.com/zh/apis/xiaohongshu/shop.md) (3)

小红书商城的公开商品数据：商品搜索、商品详情和买家评价。

| 接口 | 请求 | 返回 | 价格 |
| --- | --- | --- | --- |
| [小红书商品搜索](https://dataxapi.com/zh/apis/xiaohongshu/shop/products/search.md) | `GET /v1/xiaohongshu/shop/products/search` | 商品列表 | $0.0200 / 次 |
| [小红书商品详情](https://dataxapi.com/zh/apis/xiaohongshu/shop/products/get.md) | `GET /v1/xiaohongshu/shop/products/get` | 商品 | $0.0200 / 次 |
| [小红书商品评价](https://dataxapi.com/zh/apis/xiaohongshu/shop/products/reviews/list.md) | `GET /v1/xiaohongshu/shop/products/reviews/list` | 评价列表 | $0.0200 / 次 |

## 调用前要知道的

- **每页条数**：列表每页 5 到 120 条，各接口不同。13 个列表里有 10 个能翻页：把 `page.next_cursor` 作为 `cursor` 传回，每一页是一次单独的调用。其余只有一页。
- **给不了的字段**：21 个接口里有 17 个填不满它返回的对象。每个接口的页面列出了给不了哪些，每次返回也在 `meta.unavailable` 里再写一遍：缺的字段不会被悄悄写成 0。
- **对象不存在时读起来像空结果**：小红书评论回复、小红书蒲公英关联词、小红书话题笔记、小红书商品评价、小红书蒲公英博主笔记：对象不存在和对象下面没有东西分不出来，所以返回空结果而不是 404，并按空结果计费。
- **预览结构**：有 11 个接口返回的是预览结构，字段还可能调整；其余返回统一的结构，所有平台都一样。
- **快照**：小红书热点：榜单是每 10 分钟刷新一次的快照，`meta.fetched_at` 写明是什么时候取的。

## 调用结果不对时先看这里

- **编号都是 24 位**：笔记、用户、话题、商品的编号都是 24 位十六进制。笔记链接最后一段就是编号（/explore/编号 或 /discovery/item/编号）；短链和分享口令不收。
- **搜索结果只是摘录**：搜索返回的是结果卡片，不是笔记本身：正文是摘录，标题里的表情被去掉了。用户笔记列表只给正文前 100 个字。要全文，用笔记详情。
- **能打开的链接**：搜索结果里的链接带着网页要的访问令牌，能直接打开。用户笔记列表不给链接，拿笔记编号取一次详情就有了。
- **没有浏览量**：笔记不带浏览量，平台本身不给。
- **蒲公英博主编号**：蒲公英的接口用蒲公英博主编号，从蒲公英博主搜索里取。这个搜索按博主写的内容匹配，没有博主对得上的词，也会给出沾边的博主，不返回空。

## 常见问题

### 小红书 API 怎么收费？

按次收费，没有订阅。一次 $0.0200 到 $0.0400，每个接口的页面写明自己的价格。拿到数据才扣费，失败不收。

### 需要小红书账号或 Cookie 吗？

不需要。你只拿一把 DataXAPI 的 Key：不用登录小红书，不用 Cookie，也不用养设备。接口只返回公开可见的数据。

### 数据是实时的吗？

每次调用都当场去小红书取，`meta.fetched_at` 写明取到的时间。小红书热点：榜单是每 10 分钟刷新一次的快照。结果保留 24 小时，带同一个 `Idempotency-Key` 重试不会再扣一次。

### 空结果收费吗？

列表返回空结果时照价收费：搜索已经执行了。读单个对象而对象不存在时返回 `not_found`，收不收费看接口页。

### 小红书改版了怎么办？

调用失败不管什么原因都不扣费。被暂停的接口返回 `capability_paused`，同样不扣费；`GET /v1/catalog/status` 写着现在哪些能用。

## 怎么做和常见问题

- [如何批量获取小红书笔记评论](https://dataxapi.com/zh/guides/xiaohongshu-note-comments.md)
- [如何查小红书蒲公英博主报价和粉丝画像](https://dataxapi.com/zh/guides/xiaohongshu-pgy-creator-rates.md)
- [如何按关键词搜索并导出小红书笔记](https://dataxapi.com/zh/guides/xiaohongshu-search-export-notes.md)
- [如何查小红书蒲公英关键词的搜索指数和关联词](https://dataxapi.com/zh/guides/xiaohongshu-pgy-keywords.md)
- [小红书数据怎么导出？](https://dataxapi.com/zh/answers/export-xiaohongshu-data.md)
- [ChatGPT 能读小红书吗？](https://dataxapi.com/zh/answers/can-chatgpt-read-xiaohongshu.md)
- [小红书 xsec_token 是什么？](https://dataxapi.com/zh/answers/xiaohongshu-xsec-token.md)
- [小红书笔记编号和 xhslink 短链接是什么？](https://dataxapi.com/zh/answers/xiaohongshu-note-id-and-xhslink.md)
- [小红书蒲公英 CPE 和抖音星图 CPE 有什么不同？](https://dataxapi.com/zh/answers/xiaohongshu-pgy-cpe-vs-xingtu-cpe.md)
- [小红书蒲公英是什么？通过 API 能拿到哪些博主数据？](https://dataxapi.com/zh/answers/what-is-xiaohongshu-pgy.md)

---

怎么调用、怎么计费、怎么处理报错，所有接口都一样：https://dataxapi.com/zh/llms.txt

最后核对于 2026-11-02 11:50 UTC。目录修订号 0568dd5a20b9e888。 [网页版](https://dataxapi.com/zh/apis/xiaohongshu/)
