笔记详情
查询基础笔记信息，或选择包含更多字段的完整笔记详情接口。
XHS V2 Data API
把公开数据接入你的程序
通过一个 HTTPS API 调用笔记、评论、用户与搜索数据。公开 OpenAPI 文档，使用 Token 鉴权，按接口计费。
- 全站强制 HTTPS
- Token 鉴权
- OpenAPI 可下载
GET /api/xhs/v2/balance
curl https://dataflowserver.org/api/xhs/v2/balance \
-H "Authorization: Token YOUR_TOKEN"
{
"code": 0,
"msg": "成功",
"data": { "balance": 128.5, "status": 200 }
}接口范围
围绕内容分析的 V2 能力
适合内部研究、内容分析和产品原型。每个接口的请求字段、响应结构和错误码均以在线文档为准。
评论数据
分别获取一级评论与子评论，用于评论结构和反馈分析。
用户与发布
获取用户相关信息与用户笔记列表，具体字段见响应模型。
内容搜索
通过 V2 搜索接口查询内容，并按文档提供的分页方式继续请求。
按次计费
先看清单价，再调用
Token 是 DataFlow API 的站内计费单位。以下是当前 V2 文档中的常见单价示例，最终价格以文档和登录后的购买页面为准。
常用查询
45 Token / 次
- 笔记详情
- 一级评论与子评论
- 用户信息
扩展查询
60 Token / 次
- 完整笔记详情
- 内容搜索
- 用户笔记列表
余额查询为 0 Token；服务端错误和超时的扣费规则请查看在线文档。
使用边界
独立服务，透明说明
DataFlow API 是独立第三方服务，不隶属于小红书，也不代表小红书官方。返回内容依赖第三方平台数据链路，因此不承诺数据始终完整、实时或持续可用。
使用者应确保调用方式和数据用途符合适用法律、目标平台规则及数据保护要求。登录和注册时只需使用 DataFlow 自有帐号，请勿输入小红书、支付平台或其他第三方帐号密码、验证码。
FAQ
接入前常见问题
如何获取和使用 Token？
注册并登录 DataFlow 帐号后获取 Token。调用接口时添加请求头 Authorization: Token <token>，不要把 Token 写入公开仓库或前端代码。
有机器可读的接口规范吗？
有。你可以直接读取 OpenAPI JSON，或在交互式文档中查看接口。
能通过 MCP 使用吗？
可以。开源的 DataFlow MCP 服务只封装 XHS V2 接口，实际请求仍由你的 DataFlow Token 发送到本服务。
接口失败会扣费吗？
文档列出的服务器内部错误、繁忙和超时不计费。其他响应及最新规则以 V2 在线文档为准。
遇到安全问题如何联系？
请发送邮件至 lukalaoban@gmail.com，也可以查看 security.txt。