Xiaohongshu (RedNote) Data API

Reliable public Xiaohongshu (RedNote) notes, media, top-level comments, author profiles, cursor pagination, and sequential async batches.

原始信息汇总

数据集概述：Xiaohongshu (RedNote) Data API

该API通过RapidAPI平台提供结构化的公开小红书（RedNote）笔记和作者数据访问服务。

核心功能

• 笔记数据检索：支持获取单个笔记的详细信息（包括作者、媒体、统计数据、标签、时间戳和地理位置）。
• URL解析与验证：在请求上游数据前，可解析和验证笔记及个人主页的公开URL。
• 评论数据获取：支持读取第一页评论预览，以及基于游标的分页评论，具备去重保护。
• 组合查询：通过 /note/full_from_url 端点同时获取笔记详情和评论。
• 作者数据获取：支持单个或批量检索经过身份验证的作者公开主页信息。
• 批量处理：支持同步批量请求，或提交最多50个笔记URL到顺序异步任务进行处理。
• 短链接解析：支持解析 xhslink.com 等公开短链接。
• 原始模式：部分数据端点支持 raw=true 参数，返回经清理的上游原始上下文数据。

端点列表

API共包含18个端点，分为4组：

方法	端点路径	功能
系统
GET	/health	轻量级服务健康检查
GET	/ready	检查API是否准备好接收上游请求
笔记
GET	/note/parse_url	解析完整的小红书笔记URL，不获取数据
GET	/note/detail	通过 note_id 和 xsec_token 获取标准化笔记
GET	/note/detail_from_url	通过完整公开URL获取标准化笔记
GET	/note/media_from_url	获取结构化媒体清单（图片、视频等）
POST	/note/batch_detail_from_url	批量获取多个公开笔记URL的标准化详情
GET	/note/comments_preview_from_url	获取第一页评论预览
GET	/note/comments_from_url	获取带游标分页的顶级评论
GET	/note/full_from_url	获取笔记详情及一个游标分页评论页
POST	/note/async_batch_detail_from_url	提交最多50个笔记URL进行异步后台处理
GET	/note/async_batch_detail_result	轮询并获取异步批量任务的逐项结果
用户
GET	/user/profile	通过 user_id 获取标准化作者主页
GET	/user/profile_from_url	通过公开主页URL获取标准化作者主页
GET	/user/parse_url	本地验证主页URL并提取作者ID
POST	/user/batch_profiles	从JSON数组批量获取1-5个作者主页
工具
GET	/url/shortlink	解析支持的XHS短链接或 xhslink.com 链接
POST	/note/batch_parse_url	批量解析多个完整笔记URL

基础信息

• API版本：1.0.0
• 基础URL：https://xiaohongshu-rednote-data-api.p.rapidapi.com
• 认证方式：通过RapidAPI的 X-RapidAPI-Key 和 X-RapidAPI-Host 头进行认证。
• 响应结构：一致的 code, msg, data, data.request_id 结构。
• 数据说明：未知来源的字段值返回 null，不会伪造零值或布尔值；布尔值 false 仅在上游明确报告时才返回。

使用限制与注意事项

• 公开链接令牌：笔记详情和评论端点需要包含 xsec_token 的完整当前公开URL，该令牌可能会过期，需刷新。
• 评论分页：游标绑定到原始笔记URL，不支持跨资源复用，且具有去重保护。
• 异步批量任务：一次最多提交50个URL，任务按顺序处理，结果在24小时后过期。
• 响应契约：上游分页偶尔不可用时，会返回可重试的 503 错误码。
• 媒体URL：媒体URL可能是签名或临时的，应尽快使用。
• 搜索功能：当前版本不提供笔记搜索或子评论回复的端点。
• 独立性声明：该API为独立服务，与小红书/RedNote无关联、背书或运营关系。