小红书 / RedNote 视频与图片下载 API
使用 小红书 / RedNote 视频下载 API 解析已支持的公开链接,返回视频、图片、音频和清理敏感字段后的平台全量数据。
xhslink.com 与 xhslink.cn 分享短链会在进入笔记流程前解析完成;EasyDown 只映射作品媒体,不会把作者头像混入可下载图片列表。
同时覆盖小红书视频下载和 RedNote 视频下载场景,并支持已列出的短链格式。
当你既需要稳定的可下载媒体,又需要平台专属字段时,使用此接口。
接口地址
POST https://api.easydown.org/api/v1/platforms/xiaohongshu/parse
支持的 URL 格式
xiaohongshu.com/explore/{id}xiaohongshu.com/discovery/item/{id}rednote.com/explore/{id}xhslink.com/{path}xhslink.cn/{path}
可用示例
https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3https://www.xiaohongshu.com/explore/671e2c6500000000210016b9https://www.rednote.com/explore/6a51ee42000000001702879fhttp://xhslink.com/o/2CxGwu8nSPx
该平台响应会返回什么
图文笔记返回全部内容图片和首帧候选;视频笔记返回映射后的视频及相关作品图片,并保持源顺序。
已发布的平台数据字段
接口会保留目标作品最终响应中的其他公开字段,并递归删除敏感字段。下表字段在当前 platformDataVersion 内保持稳定。
| 字段 | 类型 | 说明 |
|---|---|---|
data.media | object | 统一的图片、视频、音频、标题、封面和时长。 |
data.platformDataVersion | string | 小红书 / RedNote的公开数据契约版本,当前为 1。 |
data.platformData.note_id | string | 目标作品在平台中的公开标识,请按字符串保存以避免大整数精度丢失。 |
data.platformData.title | string | 目标作品公开展示的标题、正文或说明文字。 |
data.platformData.desc | string | 目标作品公开展示的标题、正文或说明文字。 |
data.platformData.type | string | 目标作品在平台响应中的公开字段。 |
data.platformData.user | object | 目标作品作者的公开资料字段,不包含联系方式或鉴权信息。 |
data.platformData.images_list | array | 目标作品的图片、封面或图集项目;数组顺序与平台返回顺序一致。 |
data.platformData.video_info_v2 | object | 目标作品的视频播放、清晰度、编码、尺寸和媒体地址信息。 |
data.platformData.interact_info | object | 平台公开展示的播放、点赞、评论、收藏或分享等互动统计。 |
data.platformData.native_voice_info | object | 目标作品的公开配乐、原声或独立音轨信息。 |
真实调用样例
- 示例链接
- https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3
- Endpoint
- /api/v1/platforms/xiaohongshu/parse
- 本次扣费
- 10 credits
- 缓存
- HIT
- 采集时间
- 2026-09-17T05:08:25.822Z
通用格式
通用接口会把同一个媒体对象直接放在 `data` 中返回。
{
"status": 200,
"data": {
"platform": "xiaohongshu",
"title": "缸内无管件底滤缸,效果展示",
"thumbnail": "https://sns-i11.rednotecdn.com/110/0/01e7f75af2487310001000000001961e3b9cff_0.jpg?imageView2/2/w/1080/format/jpg&ap=1&sc=V_FRM&sign=1eb2c34cb87335a056a92d814826e523&t=6aab5d14",
"duration": 0,
"images": [
{
"url": "https://sns-i11.rednotecdn.com/1040g00831g383cc50i005npj8cjg90m2cbqafpg?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=V_ORG&sign=fd89169f35e920fdb1828b3423b31e18&t=6aab5d14",
"width": 1080,
"height": 1440
},
{
"url": "https://sns-i11.rednotecdn.com/110/0/01e7f75af2487310001000000001961e3b9cff_0.jpg?imageView2/2/w/1080/format/jpg&ap=1&sc=V_FRM&sign=1eb2c34cb87335a056a92d814826e523&t=6aab5d14",
"width": 1080,
"height": 1920
}
],
"videos": [
{
"url": "http://sns-v28.rednotecdn.com/stream/79/110/258/01e7f75af24873104f037001961e3bf878_258.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v11.rednotecdn.com/stream/79/110/258/01e7f75af24873104f037001961e3bf878_258.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v27.rednotecdn.com/stream/79/110/258/01e7f75af24873104f037001961e3bf878_258.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v28.rednotecdn.com/stream/1/110/96/01e7f75af248731001037001961ef8e700_96.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v11.rednotecdn.com/stream/1/110/96/01e7f75af248731001037001961ef8e700_96.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v27.rednotecdn.com/stream/1/110/96/01e7f75af248731001037001961ef8e700_96.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v28.rednotecdn.com/stream/1/110/97/01e7f75af248731001037001961ef7b73d_97.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v11.rednotecdn.com/stream/1/110/97/01e7f75af248731001037001961ef7b73d_97.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v27.rednotecdn.com/stream/1/110/97/01e7f75af248731001037001961ef7b73d_97.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v28.rednotecdn.com/stream/1/110/98/01e7f75af248731001037001961ef85b46_98.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v11.rednotecdn.com/stream/1/110/98/01e7f75af248731001037001961ef85b46_98.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v27.rednotecdn.com/stream/1/110/98/01e7f75af248731001037001961ef85b46_98.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
}
],
"audios": [
{
"url": "http://sns-v11.rednotecdn.com/audio/1/02e7f75b092aec9401037003961e3ba2ab_0.m4a?sign=2599f43ab475a6633525e72c3a3ff067&t=6aab5d14",
"quality": "Original",
"mimeType": "audio/mpeg",
"bitrate": 0,
"source": "native_voice",
"headers": {}
}
]
},
"msg": "success"
}平台完整格式
平台专用接口会同时返回通用媒体结构和清理后的平台完整数据。
{
"status": 200,
"data": {
"media": {
"platform": "xiaohongshu",
"title": "缸内无管件底滤缸,效果展示",
"thumbnail": "https://sns-i11.rednotecdn.com/110/0/01e7f75af2487310001000000001961e3b9cff_0.jpg?imageView2/2/w/1080/format/jpg&ap=1&sc=V_FRM&sign=1eb2c34cb87335a056a92d814826e523&t=6aab5d14",
"duration": 0,
"images": [
{
"url": "https://sns-i11.rednotecdn.com/1040g00831g383cc50i005npj8cjg90m2cbqafpg?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=V_ORG&sign=fd89169f35e920fdb1828b3423b31e18&t=6aab5d14",
"width": 1080,
"height": 1440
},
{
"url": "https://sns-i11.rednotecdn.com/110/0/01e7f75af2487310001000000001961e3b9cff_0.jpg?imageView2/2/w/1080/format/jpg&ap=1&sc=V_FRM&sign=1eb2c34cb87335a056a92d814826e523&t=6aab5d14",
"width": 1080,
"height": 1920
}
],
"videos": [
{
"url": "http://sns-v28.rednotecdn.com/stream/79/110/258/01e7f75af24873104f037001961e3bf878_258.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v11.rednotecdn.com/stream/79/110/258/01e7f75af24873104f037001961e3bf878_258.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v27.rednotecdn.com/stream/79/110/258/01e7f75af24873104f037001961e3bf878_258.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v28.rednotecdn.com/stream/1/110/96/01e7f75af248731001037001961ef8e700_96.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v11.rednotecdn.com/stream/1/110/96/01e7f75af248731001037001961ef8e700_96.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v27.rednotecdn.com/stream/1/110/96/01e7f75af248731001037001961ef8e700_96.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 720,
"height": 1280,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v28.rednotecdn.com/stream/1/110/97/01e7f75af248731001037001961ef7b73d_97.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v11.rednotecdn.com/stream/1/110/97/01e7f75af248731001037001961ef7b73d_97.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v27.rednotecdn.com/stream/1/110/97/01e7f75af248731001037001961ef7b73d_97.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v28.rednotecdn.com/stream/1/110/98/01e7f75af248731001037001961ef85b46_98.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v11.rednotecdn.com/stream/1/110/98/01e7f75af248731001037001961ef85b46_98.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
},
{
"url": "http://sns-v27.rednotecdn.com/stream/1/110/98/01e7f75af248731001037001961ef85b46_98.mp4",
"quality": "FHD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct",
"headers": {}
}
],
"audios": [
{
"url": "http://sns-v11.rednotecdn.com/audio/1/02e7f75b092aec9401037003961e3ba2ab_0.m4a?sign=2599f43ab475a6633525e72c3a3ff067&t=6aab5d14",
"quality": "Original",
"mimeType": "audio/mpeg",
"bitrate": 0,
"source": "native_voice",
"headers": {}
}
]
},
"platformData": {
"ip_location": "Shandong",
"user": {
"red_official_verified": false,
"id": "5f33432700000000010082c2",
"fstatus": "none",
"userid": "5f33432700000000010082c2",
"show_red_official_verify_icon": false,
"red_official_verify_type": 0,
"track_duration": 0,
"level": {
"image": ""
},
"image": "https://sns-avatar-qc.rednotecdn.com/avatar/1040g2jo31eonnrfsmi005npj8cjg90m20p9jnog?imageView2/2/w/80/format/jpg",
"followed": false,
"red_id": "49919046142",
"preload_posted": false,
"name": "净空水族",
"nickname": "净空水族"
},
"id": "67f75b07000000000b0154b3",
"feedback_info": {
"dislike_status": 0
},
"last_update_time": 0,
"comments_count": 211,
"has_related_goods": false,
"collected": false,
"liked": false,
"auto_slide_down": 0,
"foot_tags": [],
"pre_view_count": -1,
"share_code_flag": 0,
"regenerate_bit_map": 0,
"related_goods_num": 0,
"lazy_load_mode": 0,
"liked_count": 1172,
"title": "缸内无管件底滤缸,效果展示",
"share_info": {
"content": "#鱼缸过滤 #空气缸",
"show_wechat_tag": false,
"title": "缸内无管件底滤缸,效果展示",
"image": "http://sns-img-hw.xhscdn.com/1040g00831g383cc50i005npj8cjg90m2cbqafpg?imageView2/2/w/360/format/jpg/q/75",
"is_star": false,
"block_private_msg": false,
"function_entries": [
{
"type": "video_download"
},
{
"type": "generate_image"
},
{
"type": "quote_note"
},
{
"type": "copy_link"
},
{
"type": "heat_for_author"
},
{
"type": "small_window"
},
{
"options": [
"auto_small_window",
"video_mute_play"
],
"type": "play_setting"
},
{
"type": "video_speed"
},
{
"type": "dislike"
},
{
"type": "report"
},
{
"type": "video_feedback"
}
],
"wechat_share_desc": "@净空水族's note\n423 Shares",
"link": "https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3?app_platform=ios&app_version=9.42&share_from_user_hidden=true&xsec_source=app_share&type=video&xsec_token=CBEMrb81ncIm0q23mm5P0wsKlqSXlWXBoA8_Rd--dn6so=&author_share=1",
"guide_audited": true
},
"sticky": false,
"seeded_count": 0,
"need_next_step": false,
"content_trans_info": {
"strategy": 9
},
"hash_tag": [
{
"indicator": "",
"record_count": 0,
"id": "5ea596dd00000000010074b2",
"tag_hint": "",
"bizId": "",
"record_emoji": "",
"link": "xhsdiscover://rn/sns-discover/topic/normal?id=5ea596dd671de20001eb7a7d&page_source=note_feed.click_new_big",
"record_unit": "",
"type": "topic",
"name": "鱼缸过滤",
"current_score": 0
},
{
"indicator": "",
"record_count": 0,
"tag_hint": "",
"id": "5fcdc3dc0000000001001fda",
"bizId": "",
"record_emoji": "",
"link": "xhsdiscover://rn/sns-discover/topic/normal?id=5fcdc3dcead3580001ca8ad2&page_source=note_feed.click_new_big",
"record_unit": "",
"type": "topic",
"current_score": 0,
"name": "空气缸"
}
],
"text_language_code": "zh-Hans",
"video_info_v2": {
"capa": {
"is_user_select": false,
"is_upload": false,
"frame_ts": 0,
"duration": 27
},
"consumer": {
"can_super_resolution": false
},
"image": {
"thumbnail": "https://sns-i11.rednotecdn.com/110/0/01e7f75af2487310001000000001961e3bae4f_0.webp?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=V_ORG&sign=0a227451466c98f7207d5f5d004500dc&t=6aab5d14",
"thumbnail_dim": "https://sns-i11.rednotecdn.com/110/0/01e7f75af2487310001000000001961e3bae4f_0.webp?imageView2/2/w/720/h/720/format/webp&ap=1&sc=V_SPRT&sign=0a227451466c98f7207d5f5d004500dc&t=6aab5d14",
"first_frame": "https://sns-i11.rednotecdn.com/110/0/01e7f75af2487310001000000001961e3b9cff_0.jpg?imageView2/2/w/1080/format/jpg&ap=1&sc=V_FRM&sign=1eb2c34cb87335a056a92d814826e523&t=6aab5d14"
},
"media": {
"user_level": 0,
"audio_stream": {},
"video": {
"drm_type": 0,
"bbox": {
"ocr_v3": [
{
"y": 0,
"w": 0,
"x": 0,
"h": 0
}
],
"ocr_v4": [
{
"y": 0,
"w": 0,
"x": 0,
"h": 0
}
],
"ocr_v5": [
{
"y": 0,
"w": 0,
"x": 0,
"h": 0
}
],
"ocr_v2": [
{
"y": 0,
"w": 0,
"x": 0,
"h": 0
}
]
},
"subtitles": {
"en-US": [
{
"language": "en-US",
"url": "https://sns-subtitle-s8.rednotecdn.com/subtitle/1/110/1/01e7f75af24873100103700397a33a5c7b_12.srt?sign=8b0493f2a0fcd0467f5d321d38eaa3cc&t=6aaffa54",
"type": 0,
"format": 0
}
],
"zh-CN": [
{
"language": "zh-CN",
"url": "https://sns-subtitle-s8.rednotecdn.com/subtitle/1/110/1/01e7f75af24873100103700397a33a4365_11.srt?sign=ce13c274996ca49364319ac3e9f1aa08&t=6aaffa54",
"type": 0,
"format": 0
}
],
"source": [
{
"language": "zh-CN",
"url": "https://sns-subtitle-s8.rednotecdn.com/subtitle/1/110/1/01e7f75af24873100103700397a327f39a_1.srt?sign=320e85203717e8db2388b2b8ee0d6921&t=6aaffa54",
"type": 0,
"format": 0
}
]
},
"biz_id": "281465472068441267",
"width": 1080,
"opaque1": {
"domestic": "0",
"isSupportSubtitle": "true",
"amend_mobile": "40",
"videoLanguage": "[\"zh-CN\"]",
"audioLevInfo": "{\"audio_quality_level\":\"G+\",\"mos_overall\":3.6411,\"version\":\"3.0\"}",
"audioClsInfo": "{\"music_ratio\":0.9992797623593891,\"freesound_ratio\":0.0,\"speech_ratio\":0.0}",
"loudnorm": "{\"lra\":0.6,\"htp\":0.41,\"hldn\":-6.86,\"ldn\":-6.84,\"thr\":-16.85}",
"hasHumanVoice": "true"
},
"hdr_type": 0,
"biz_name": 110,
"height": 1920,
"duration": 28,
"md5": "1c100f3e5a51b5e0c39e5982b70291df",
"stream_types": [
258,
96,
97,
98
],
"bound": [
{
"y": 0,
"w": 0,
"x": 0,
"h": 0
}
]
},
"stream": {
"h265": [
{
"audio_bitrate": 128100,
"stream_type": 96,
"master_url": "http://sns-v28.rednotecdn.com/stream/1/110/96/01e7f75af248731001037001961ef8e700_96.mp4",
"weight": 62,
"volume": 0,
"video_duration": 27866,
"duration": 27889,
"vmaf": -1,
"psnr": 37.89699935913086,
"video_codec": "hevc",
"audio_channels": 2,
"default_stream": 1,
"backup_urls": [
"http://sns-v11.rednotecdn.com/stream/1/110/96/01e7f75af248731001037001961ef8e700_96.mp4",
"http://sns-v27.rednotecdn.com/stream/1/110/96/01e7f75af248731001037001961ef8e700_96.mp4"
],
"video_bitrate": 386417,
"fps": 30,
"opaque1": {
"didLoudnorm": "false",
"pcdn_302_flag": "false",
"use_pcdn": "1",
"pcdn_supplier": ""
},
"size": 1817084,
"audio_codec": "aac",
"rotate": 0,
"format": "mp4",
"sr": 0,
"stream_desc": "R265_MP4_720P_96_IOS",
"height": 1280,
"width": 720,
"audio_duration": 27888,
"quality_type": "HD",
"avg_bitrate": 521233,
"hdr_type": 0,
"ssim": 0
},
{
"audio_bitrate": 128100,
"stream_type": 97,
"master_url": "http://sns-v28.rednotecdn.com/stream/1/110/97/01e7f75af248731001037001961ef7b73d_97.mp4",
"weight": 73,
"volume": 0,
"video_duration": 27866,
"duration": 27889,
"vmaf": -1,
"psnr": 37.30500030517578,
"video_codec": "hevc",
"audio_channels": 2,
"default_stream": 0,
"backup_urls": [
"http://sns-v11.rednotecdn.com/stream/1/110/97/01e7f75af248731001037001961ef7b73d_97.mp4",
"http://sns-v27.rednotecdn.com/stream/1/110/97/01e7f75af248731001037001961ef7b73d_97.mp4"
],
"video_bitrate": 765276,
"fps": 30,
"opaque1": {
"didLoudnorm": "false",
"pcdn_302_flag": "false",
"use_pcdn": "1",
"pcdn_supplier": ""
},
"size": 3136776,
"audio_codec": "aac",
"rotate": 0,
"format": "mp4",
"sr": 0,
"stream_desc": "R265_MP4_1080P_97_IOS_low",
"height": 1920,
"width": 1080,
"audio_duration": 27888,
"quality_type": "FHD",
"avg_bitrate": 899788,
"hdr_type": 0,
"ssim": 0
},
{
"audio_bitrate": 128100,
"stream_type": 98,
"master_url": "http://sns-v28.rednotecdn.com/stream/1/110/98/01e7f75af248731001037001961ef85b46_98.mp4",
"weight": 78,
"volume": 0,
"video_duration": 27866,
"duration": 27889,
"vmaf": -1,
"psnr": 38.84299850463867,
"video_codec": "hevc",
"audio_channels": 2,
"default_stream": 0,
"backup_urls": [
"http://sns-v11.rednotecdn.com/stream/1/110/98/01e7f75af248731001037001961ef85b46_98.mp4",
"http://sns-v27.rednotecdn.com/stream/1/110/98/01e7f75af248731001037001961ef85b46_98.mp4"
],
"video_bitrate": 1345371,
"fps": 30,
"opaque1": {
"didLoudnorm": "false",
"pcdn_302_flag": "false",
"use_pcdn": "1",
"pcdn_supplier": ""
},
"size": 5157440,
"audio_codec": "aac",
"rotate": 0,
"format": "mp4",
"sr": 0,
"stream_desc": "R265_MP4_1080P_98_IOS_high",
"height": 1920,
"width": 1080,
"audio_duration": 27888,
"quality_type": "FHD",
"avg_bitrate": 1479419,
"hdr_type": 0,
"ssim": 0
}
],
"h266": [],
"h264": [
{
"audio_bitrate": 56282,
"stream_type": 258,
"master_url": "http://sns-v28.rednotecdn.com/stream/79/110/258/01e7f75af24873104f037001961e3bf878_258.mp4",
"weight": 59,
"volume": 0,
"video_duration": 27866,
"duration": 27867,
"vmaf": -1,
"psnr": 0,
"video_codec": "h264",
"audio_channels": 2,
"default_stream": 0,
"backup_urls": [
"http://sns-v11.rednotecdn.com/stream/79/110/258/01e7f75af24873104f037001961e3bf878_258.mp4",
"http://sns-v27.rednotecdn.com/stream/79/110/258/01e7f75af24873104f037001961e3bf878_258.mp4"
],
"video_bitrate": 1159955,
"fps": 30,
"opaque1": {
"didLoudnorm": "false",
"pcdn_302_flag": "false",
"use_pcdn": "0",
"pcdn_supplier": ""
},
"size": 4260671,
"audio_codec": "aac",
"rotate": 0,
"format": "mp4",
"sr": 0,
"stream_desc": "X264_MP4",
"height": 1280,
"width": 720,
"audio_duration": 27862,
"quality_type": "HD",
"avg_bitrate": 1223144,
"hdr_type": 0,
"ssim": 0
}
],
"av1": []
},
"video_id": "137350283642041104"
}
},
"type": "video",
"topics": [
{
"style": 0,
"id": "5ea596dd00000000010074b2",
"activity_online": false,
"image": "http://ci.xiaohongshu.com/fd75707a-37f8-45ad-b7a7-0feaf36e9cad@r_120w_120h.jpg",
"link": "xhsdiscover://topic/v2/5ea596dd671de20001eb7a7d?page_source=note_feed.click_new_big",
"business_type": 0,
"discuss_num": 0,
"name": "鱼缸过滤"
}
],
"desc": "缸内无管件底滤缸,效果展示\n#鱼缸过滤[话题]# #空气缸[话题]#",
"countdown": 0,
"ats": [],
"has_no_more": false,
"widgets_groups": [
[
"guos_test",
"note_next_step",
"second_jump_bar",
"note_collection",
"cooperate_binds",
"rec_next_infos",
"video_marks",
"product_review",
"related_search",
"video_goods_cards",
"cooperate_comment_component",
"ads_goods_cards",
"ads_comment_component",
"goods_card_v2",
"video_recommend_tag",
"buyable_goods_card_v2",
"cooperate_search_component",
"ads_engage_bar",
"challenge_card",
"cooperate_engage_bar",
"pgy_comment_component",
"pgy_engage_bar",
"related_recommend",
"next_note_guide",
"widgets_ndb",
"pgy_bbc_exp",
"brand_max_trailer",
"super_activity",
"note_nice_guide",
"pin_search_highlights",
"widgets_enhance",
"packed_goods",
"packed_buyable_goods",
"widgets_ncb",
"note_nice_compound",
"live_shooting_flag",
"widgets_nbb",
"poi_declare",
"async_group"
],
[
"guos_test",
"vote_stickers",
"bullet_comment_lead",
"note_search_box",
"interact_pk",
"interact_vote",
"guide_heuristic",
"guide_post",
"video_foot_bar",
"follow_guide",
"share_to_msg",
"note_share_prompt_v1",
"note_share_prompt_v2",
"group_share",
"share_guide_bubble",
"goods_enhance_component",
"guide_navigator",
"sync_group"
]
],
"enable_brand_lottery": false,
"api_upgrade": -1,
"need_product_review": false,
"media_save_config": {
"disable_save": false,
"disable_watermark": false,
"disable_weibo_cover": false
},
"cny_red_envelope_note": false,
"native_voice_info": {
"sound_id": "1146156600522646408",
"use_count": 2,
"url": "http://sns-v11.rednotecdn.com/audio/1/02e7f75b092aec9401037003961e3ba2ab_0.m4a?sign=2599f43ab475a6633525e72c3a3ff067&t=6aab5d14",
"deeplink": "xhsdiscover://post_new_note?guiders=%5B%7B%22page_position%22%3A%22album%22%2C%22content%22%3A%22Select%20and%20tap%20Next%20Step%20to%20add%20the%20music%22%7D%2C%7B%22page_position%22%3A%22take_photo%22%2C%22content%22%3A%22Ready%20to%20add%20the%20music%20in%20your%20notes%22%7D%2C%7B%22page_position%22%3A%22take_video%22%2C%22content%22%3A%22Ready%20to%20add%20the%20music%20in%20your%20notes%22%7D%5D&page=%7B%22page_type%22%3A%22albums%22%7D&attach=%7B%22sound_track%22%3A%7B%22id%22%3A%221146156600522646408%22%7D%7D&source=%7B%22type%22%3A%22leica%22%2C%22extraInfo%22%3A%7B%22track_id%22%3A%2267f75b07000000000b0154b3%22%2C%22style%22%3A%22ordinary%22%2C%22subType%22%3A%22NNS_TYPE_SOUND_TRACK%22%2C%22page_entrance_type%22%3A%22note_detail%22%2C%22note_feed_type_str%22%3A%22%22%2C%22nns_id%22%3A%221146156600522646408%22%2C%22is_related_notes%22%3Atrue%7D%7D",
"disable_panel": true
},
"shared_count": 423,
"images_list": [
{
"index": 0,
"fileid": "1040g00831g383cc50i005npj8cjg90m2cbqafpg",
"url_size_large": "",
"scale_to_large": 0,
"longitude": 0,
"width": 1080,
"url": "https://sns-i11.rednotecdn.com/1040g00831g383cc50i005npj8cjg90m2cbqafpg?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=1&sc=V_PRV&sign=fd89169f35e920fdb1828b3423b31e18&t=6aab5d14",
"original": "https://sns-i11.rednotecdn.com/1040g00831g383cc50i005npj8cjg90m2cbqafpg?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=V_ORG&sign=fd89169f35e920fdb1828b3423b31e18&t=6aab5d14",
"latitude": 0,
"need_load_original_image": false,
"height": 1440
}
],
"comment_prompt_config": {
"placeholder_long": "Say something...",
"placeholder_short": "Say something",
"forbidden_cmt_type": 0
},
"may_have_red_packet": false,
"final_feed_item": false,
"enable_fls_bridge_cards": false,
"hide_button": false,
"seeded": false,
"model_type": "note",
"enable_listen_video": false,
"cooperate_binds": [],
"track_id": "",
"view_count": 0,
"function_switch": [
{
"type": "video_download",
"enable": false,
"reason": "Download disabled by author"
},
{
"enable": true,
"type": "quote_note"
},
{
"type": "heat_for_author",
"enable": true
}
],
"source_note": true,
"source_item": false,
"time": 1744263943,
"nice_info": {
"display": true,
"nice_status": 2
},
"cursor_score": "",
"collected_count": 547,
"downgrade_type": 0,
"privacy": {
"type": 0,
"show_tips": false,
"nick_names": ""
},
"interaction_info": {
"niced": false,
"nice_count": 36,
"share_count": 423
},
"enable_fls_related_cards": false,
"qq_mini_program_info": {
"share_title": "@净空水族 发了一篇超赞的笔记,快点来看!",
"webpage_url": "https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3?xsec_source=app_share&xsec_token=CBEMrb81ncIm0q23mm5P0wsKlqSXlWXBoA8_Rd--dn6so=",
"thumb": "http://sns-img-hw.xhscdn.com/1040g00831g383cc50i005npj8cjg90m2cbqafpg?imageView2/2/w/540/format/jpg/q/75",
"title": "@净空水族 发了一篇超赞的笔记,快点来看!",
"user_name": "gh_66c53d495417",
"path": "pages/main/note/index?xsec_source=app_share&id=67f75b07000000000b0154b3&type=video&xsec_token=CBEMrb81ncIm0q23mm5P0wsKlqSXlWXBoA8_Rd--dn6so=",
"desc": "#鱼缸过滤 #空气缸"
},
"widgets_context": "{\"video\":true,\"origin_video_key\":\"pre_post/1040g2t031g382pu400e05npj8cjg90m20aoh5c0\",\"flags\":{\"sound_track\":true},\"author_id\":\"5f33432700000000010082c2\",\"author_name\":\"净空水族\",\"note_sound_info\":{\"sound_id\":\"1146156600522646408\",\"name\":\"净空水族的原声\",\"desc\":\"@净空水族创作的原声\",\"duration\":27862,\"url\":\"http://sns-v11.rednotecdn.com/audio/1/02e7f75b092aec9401037003961e3ba2ab_0.m4a?sign=2599f43ab475a6633525e72c3a3ff067&t=6aab5d14\",\"use_count\":2,\"subtitle\":\"净空水族的原声\",\"sound_bg_music_type\":1,\"cover\":\"https://picasso-static.xiaohongshu.com/fe-platform/b598691aefe712c51cbe29af0ddbe732937bc965.png\",\"creator\":\"5f33432700000000010082c2\",\"user_nickname\":\"净空水族\"},\"video_duration\":27,\"video_rec_bar_info\":\"\",\"share_count\":423}"
},
"platformDataVersion": "1"
},
"msg": "success"
}下载与代理建议
后端请求携带小红书 Referer 与浏览器 User-Agent。图片和视频 CDN 可能检查防盗链、Cookie、过期 URL 和地区访问。
限制与行为
不支持主页、搜索页、合集、私密笔记、已删除笔记、仅登录可见媒体和地区不可用内容。
仅支持公开内容。私密、已删除、年龄限制、地区限制、直播或其他不可用内容可能解析失败,失败不消耗额度。
小红书 / RedNote 成功解析一次扣 10 credits。失败、不支持、鉴权失败、权限错误、无媒体和上游故障响应均扣 0 credits。 X-Credits-Charged 会返回本次成功响应实际扣除的 credits。
故障排查
- 公开页面需要访问参数时,保留完整笔记 URL。
- 通过后端代理媒体,不要让浏览器直接请求小红书 CDN。
- 短链或媒体 URL 过期后重新解析再重试。
常见问题
失败请求会消耗额度吗?
不会。只有 API 成功返回可下载媒体后才按平台费率扣 credits。
为什么有效的公开链接仍可能失败?
作品可能已经删除、设为私密、存在地区限制、属于直播、没有可下载媒体,或上游服务暂时不可用。
相关指南
交互式 API 参考
下方 curl、JavaScript、Python 示例和接口模式定义均由生产 OpenAPI 3.1 契约生成。
在线调试面板会直接请求 api.easydown.org。Token 只保存在当前页面内存中,刷新后立即清除。
在线调试
Authorization
bearerAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/platforms/xiaohongshu/parse" \ -H "Content-Type: application/json" \ -d '{}'{ "status": 200, "data": { "media": { "platform": "tiktok", "title": "string", "thumbnail": "string", "duration": 0, "images": [ { "url": "http://example.com", "width": 0, "height": 0 } ], "videos": [ { "url": "http://example.com", "quality": "string", "mimeType": "string", "width": 0, "height": 0, "hasAudio": true, "source": "direct", "headers": { "property1": "string", "property2": "string" } } ], "audios": [ { "url": "http://example.com", "quality": "string", "mimeType": "string", "bitrate": 0, "source": "direct", "headers": { "property1": "string", "property2": "string" } } ] }, "platformData": { "note_id": "string", "title": "string", "desc": "string", "type": "string", "user": {}, "images_list": [ null ], "video_info_v2": {}, "interact_info": {}, "native_voice_info": {} }, "platformDataVersion": "1" }, "msg": "success"}