媒体下载与代理规则
后端请求携带小红书 Referer 与浏览器 User-Agent。图片和视频 CDN 可能检查防盗链、Cookie、过期 URL 和地区访问。
建议的后端请求头
User-Agent: Mozilla/5.0
Referer: https://www.xiaohongshu.com/
Range: bytes=0-EasyDown REST API 平台指南
小红书 / RedNote 媒体下载 API
分享短链会在进入笔记流程前解析完成；EasyDown 只映射作品媒体，不会把作者头像混入可下载图片列表。
使用经过鉴权的小红书 / RedNote 媒体下载 API 解析公开视频或图文笔记，保留全部笔记图片、视频、首帧和封面候选。
小红书视频下载 API · 小红书图片解析 API
生产环境 REST Endpoint
POST https://api.easydown.org/api/v1/parse支持的公开 URL 格式
xhslink.com/{code}xiaohongshu.com/explore/{noteId}xiaohongshu.com/discovery/item/{noteId}rednote.com/explore/{noteId}真实请求示例
https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3?source=webshare&xhsshare=pc_web&xsec_token=ABUzYYSiMJkyRD5slTtuDPFvfSOmaGPxm2X4Unms9L1FY=&xsec_source=pc_share
curl -X POST https://api.easydown.org/api/v1/parse \
-H "Authorization: Bearer ed_live_xxx" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3?source=webshare&xhsshare=pc_web&xsec_token=ABUzYYSiMJkyRD5slTtuDPFvfSOmaGPxm2X4Unms9L1FY=&xsec_source=pc_share"}'平台专属响应示例
统一响应外层保持稳定；具体平台决定哪些媒体数组和属性会被填充。
媒体返回行为
图文笔记返回全部内容图片和首帧候选；视频笔记返回映射后的视频及相关作品图片，并保持源顺序。
{
"status": 200,
"data": {
"platform": "xiaohongshu",
"title": "Example xiaohongshu public post",
"thumbnail": "https://cdn.example.com/thumbnail.jpg",
"duration": 24,
"images": [
{
"url": "https://cdn.example.com/content-image.jpg",
"width": 1080,
"height": 1350
}
],
"videos": [
{
"url": "https://cdn.example.com/video.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct"
}
],
"audios": []
},
"msg": "success"
}不支持或不可用的内容
不支持主页、搜索页、合集、私密笔记、已删除笔记、仅登录可见媒体和地区不可用内容。
只处理你有权使用的公开媒体。EasyDown 不绕过隐私设置、DRM、已删除内容或平台访问限制。
平台专属排错
公开页面需要访问参数时，保留完整笔记 URL。
通过后端代理媒体，不要让浏览器直接请求小红书 CDN。
短链或媒体 URL 过期后重新解析再重试。
REST 集成流程
- 1
创建私有 API Token，并在权限中允许该平台。
- 2
把一个完整的公开作品 URL POST 到统一 Endpoint。
- 3
从 images、videos、audios 中选择所需媒体并通过后端代理。
下载 API 常见问题
小红书 / RedNote 下载 API 支持哪些 URL？
支持的公开单条作品格式包括 xhslink.com/{code}, xiaohongshu.com/explore/{noteId}, xiaohongshu.com/discovery/item/{noteId}, rednote.com/explore/{noteId}。不支持主页、搜索页、合集、私密笔记、已删除笔记、仅登录可见媒体和地区不可用内容。
小红书 / RedNote 下载 API 会返回哪些媒体？
图文笔记返回全部内容图片和首帧候选；视频笔记返回映射后的视频及相关作品图片，并保持源顺序。
应用应该如何下载返回的 小红书 / RedNote 媒体 URL？
后端请求携带小红书 Referer 与浏览器 User-Agent。图片和视频 CDN 可能检查防盗链、Cookie、过期 URL 和地区访问。
小红书 / RedNote API 成功请求如何扣费？
成功返回至少一条图片、视频或音频 URL 时扣 1 credit；失败、不支持、鉴权错误和空媒体结果不扣 credits。