XHS Data API

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

原始信息汇总

XHS Data API 数据集详情

数据集概述

XHS Data API 是一个用于访问小红书（RedNote）公开数据的 HTTP API，通过 RapidAPI 网关提供服务。该 API 专注于提供稳定、标准化的笔记和作者数据获取功能。

核心功能

笔记数据

• 获取结构化笔记详情，包括互动数据、标签、时间戳、位置和媒体信息
• 验证和解析小红书笔记 URL 及作者 URL
• 获取标准化的顶级评论页面，支持服务端游标分页和去重保护
• 支持获取笔记的图片、视频和音乐可用性信息
• 提供单笔记同步处理，以及提交最多 50 个笔记 URL 的异步批量任务

作者数据

• 获取作者身份信息和作者个人资料
• 获取作者已发布的笔记列表，支持真实游标分页
• 获取作者页面级别的内容指标数据

批量处理

• 支持小规模同步批量处理
• 支持异步批量笔记详情获取，任务 24 小时后过期
• 批量端点可保留单个项目的成功结果

主要 API 端点

方法	路径	状态
GET	/health	Live
GET	/ready	Live
GET	/note/detail	Live
GET	/note/detail_from_url	Live
GET	/note/media_from_url	Live
GET	/note/comments_preview_from_url	Live
GET	/note/comments_from_url	Live
GET	/note/full_from_url	Live
POST	/note/async_batch_detail_from_url	Live
GET	/note/async_batch_detail_result	Live
GET	/url/shortlink	Live
POST	/note/batch_detail_from_url	Live
GET	/note/parse_url	Live
POST	/note/batch_parse_url	Live
GET	/user/profile	Live
GET	/user/profile_from_url	Live
GET	/user/notes	Live
GET	/user/notes_from_url	Live
GET	/user/parse_url	Live
GET	/user/overview_from_url	Live
GET	/user/content_metrics_from_url	Live
GET	/user/batch_profiles	Live

数据特性

• 所有响应使用一致的 code、msg 和 data 封装格式
• 每个响应包含 data.request_id 用于支持和错误追踪
• 游标链绑定到原始笔记或作者，拒绝跨资源重用
• 未知字段返回 null，而非伪造的零值或布尔值
• 用户笔记项会说明数据是摘要、已验证缓存详情还是显式获取的详情
• 可重试的上游故障使用结构化错误，可能包含 Retry-After
• /url/shortlink 支持完整公开笔记/作者 URL 和 HTTPS xhslink.com 短链接

重要限制

• 笔记详情和评论请求需要完整、当前的公开笔记 URL，其中包含该笔记的 xsec_token
• 公开链接令牌和签名媒体 URL 可能过期
• 不提供笔记搜索或子评论回复端点
• 该 API 独立运行，与小红书/RedNote 无关联、背书或运营关系

搜集汇总

背景与挑战

背景概述

XHS Data API 是一个可靠的小红书（RedNote）公开数据接口，能够获取笔记、媒体、顶级评论和作者资料。该API支持实时游标分页和顺序异步批处理功能，便于高效采集数据。