小红书图文与视频下载 API
图文或视频，分享一次就能识别。
粘贴小红书笔记链接或完整分享文案，自动识别图文笔记与视频笔记。图文返回原始图集，视频返回可用的视频下载地址，同时整理标题和作者信息。
¥0.02 / 成功一次 · 失败不扣费
可以获取哪些素材
图文笔记原始图集
图文结果的 media_kind 为 images，图片列表在 detail_images 中，可按顺序保存作品图片。
视频笔记下载
视频结果的 media_kind 为 video；成功转存后返回 download_url，便于下载保存视频文件。
笔记标题与作者
返回可获取的标题、作者及封面信息；字段是否存在取决于作品实际内容。
从分享链接到下载，三步完成
复制笔记分享
复制小红书图文或视频笔记的完整分享，保留短链接、查询参数和原始文案。
自动识别类型
在控制台获取或通过 API 调用，系统会识别图文与视频并返回对应素材，不必另选笔记类型。
按类型保存素材
图文依次保存图集；视频读取转存后的下载地址，并在 48 小时有效期内保存。
接入应用或直接使用
适合整理自有或已获授权的笔记图集与视频、归档创作素材，以及在应用中接入统一的笔记素材获取能力。
无需开发，可以登录控制台粘贴分享获取素材。开发者使用同一套 API Key 调用 POST /v1/ecom/xiaohongshu/download，将完整分享放入 url 参数；鉴权、返回字段、错误处理与重试方式见接口文档。
使用范围
私密、已删除、分享过期或受平台访问限制的笔记可能无法获取。原始图集链接的可用性取决于来源，不能保证长期有效；视频下载地址的 48 小时有效期仅适用于已转存视频。
常见问题
小红书视频和图文笔记需要分别选择吗？
不需要。粘贴分享后自动识别：图文返回 media_kind=images 和 detail_images，视频返回 media_kind=video，并在成功转存后返回视频下载地址。
xhslink.cn 或 xhslink.com 短链接支持吗？
支持常见小红书分享短链接和笔记链接，也支持完整分享文案。链接参数可能是访问笔记所必需的信息，请保留原始分享，不要手动删减。
小红书图文和视频怎样计费？
按获取成功次数计费，每次 ¥0.02，失败不扣费。重新获取成功属于新操作，按次计费；同次结果中的图片与转存视频可在可用期内下载。
图集和视频地址都有效 48 小时吗？
只有成功转存的视频下载地址提供 48 小时有效期。图文返回的原始图片链接取决于来源的访问规则，请及时保存；不能将视频有效期理解为图集链接的保证。
每一篇小红书笔记都可以获取吗？
不能保证。私密、已删除、分享过期或受平台访问限制的笔记可能无法获取。遇到错误请按提示保留完整分享或稍后重试，仅获取你有权使用的内容。