Platform Video Downloader APIs
RedNote / Xiaohongshu Video Downloader API
Use EasyDown's RedNote / Xiaohongshu video downloader API for supported public URLs. Return downloadable video, images, audio, and sanitized platform data.
xhslink.com and xhslink.cn share URLs are resolved before the note workflow runs. EasyDown maps content media only and avoids mixing author avatars into the downloadable image list.
Use it for both RedNote downloader and Xiaohongshu video downloader integrations, including supported short links.
Use this endpoint when you need platform-specific fields in addition to stable downloadable media.
Endpoints
POST https://api.easydown.org/api/v1/platforms/xiaohongshu/parse
Supported URL formats
xiaohongshu.com/explore/{id}xiaohongshu.com/discovery/item/{id}rednote.com/explore/{id}xhslink.com/{path}xhslink.cn/{path}
Accepted examples
https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3https://www.xiaohongshu.com/explore/671e2c6500000000210016b9https://www.rednote.com/explore/6a51ee42000000001702879fhttp://xhslink.com/o/2CxGwu8nSPx
What the platform response contains
Image notes return every available content image and first-frame candidate. Video notes return mapped videos plus related content images while keeping source order.
Published platform data fields
The API preserves additional public fields from the final target object after recursive sensitive-field filtering. The documented fields below remain stable for this platformDataVersion.
| Field | Type | Description |
|---|---|---|
data.media | object | Normalized images, videos, audios, title, thumbnail, and duration. |
data.platformDataVersion | string | Published data contract version for RedNote / Xiaohongshu; currently 1. |
data.platformData.note_id | string | Xiaohongshu note identifier. |
data.platformData.title | string | Public note title. |
data.platformData.desc | string | Public note description. |
data.platformData.type | string | Note media type. |
data.platformData.user | object | Public author profile fields. |
data.platformData.images_list | array | All image and live-photo items in the note. |
data.platformData.video_info_v2 | object | Video stream, codec, cover, and dimension metadata. |
data.platformData.interact_info | object | Public engagement counters. |
data.platformData.native_voice_info | object | Native voice track metadata when present. |
Real response example
- Sample URL
- https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3
- Endpoint
- /api/v1/platforms/xiaohongshu/parse
- Credits charged
- 10 credits
- Cache
- HIT
- Captured
- 2026-09-17T05:08:25.822Z
Common normalized format
The common endpoint returns this same media object directly in `data`.
/api/v1/parse response
{
"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"
}Platform full-data format
The platform endpoint returns normalized media plus the sanitized platform data object.
/api/v1/platforms/xiaohongshu/parse
{
"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"
}Download and proxy guidance
Use Referer: https://www.xiaohongshu.com/ and a browser User-Agent from your backend. Image and video CDNs can enforce anti-hotlinking, cookies, expiring URLs, and regional access.
Limits and behavior
Profiles, search pages, collections, private notes, deleted notes, login-only media, and region-unavailable content are unsupported.
Only public content is supported. Private, deleted, age-restricted, region-restricted, live, or otherwise unavailable content can fail without a credit charge.
A successful RedNote / Xiaohongshu parse costs 10 credits. Failed, unsupported, authentication, permission, no-media, and upstream failure responses charge 0 credits. X-Credits-Charged returns the actual credits charged for the successful response.
Troubleshooting
- Keep the full note URL when it contains access parameters required by the public page.
- Proxy media instead of requesting Xiaohongshu CDNs directly from a browser.
- Re-parse short or expired media URLs before retrying a download.
Common questions
Does a failed request consume credits?
No. Credits are charged only after the API returns downloadable media.
Why can a valid public link still fail?
The post can be deleted, private, region-restricted, live, missing media, or temporarily unavailable upstream.
Related guides
- All platform APIs
- Common normalized API
- All supported URL formats
- Error codes
- Downloading media
- Authentication
- Credits and billing
Interactive API reference
The curl, JavaScript, and Python examples and schemas below are rendered from the production OpenAPI 3.1 contract.
The Try it panel sends requests directly to api.easydown.org. Its token is held in React memory only and disappears on reload.
POST
Try it
Authorization
bearerAuth AuthorizationBearer <token>
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"}Threads Video Downloader API
Use EasyDown's Threads video downloader API for supported public URLs. Return downloadable video, images, audio, and sanitized platform data.
Bilibili Video Downloader API
Use EasyDown's Bilibili (mainland China) video downloader API for supported public URLs. Return downloadable video, images, audio, and sanitized platform data.