API de descarga por plataforma
API de descarga de videos de Xiaohongshu / RedNote
Usa la API de RedNote / Xiaohongshu con URL públicas compatibles y recibe videos, imágenes, audio y datos completos sin campos sensibles.
Envía una nota pública o un enlace corto compatible de RedNote/Xiaohongshu. La API devuelve el video y todos los elementos de la galería solicitada.
Úsala para integrar descarga de videos de RedNote y Xiaohongshu, incluidos los enlaces cortos compatibles.
Usa este endpoint cuando necesites campos propios de la plataforma además de medios descargables estables.
Endpoints
POST https://api.easydown.org/api/v1/platforms/xiaohongshu/parse
Formatos de URL compatibles
xiaohongshu.com/explore/{id}xiaohongshu.com/discovery/item/{id}rednote.com/explore/{id}xhslink.com/{path}xhslink.cn/{path}
Ejemplos aceptados
https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3https://www.xiaohongshu.com/explore/671e2c6500000000210016b9https://www.rednote.com/explore/6a51ee42000000001702879fhttp://xhslink.com/o/2CxGwu8nSPx
Contenido de la respuesta de la plataforma
Una nota puede devolver video, portada y todas las imágenes del carrusel, cada elemento como archivo independiente.
Campos publicados de la plataforma
La API conserva otros campos públicos del objeto final después de eliminar de forma recursiva los datos sensibles. Los campos documentados se mantienen estables durante esta versión de platformData.
| Campo | Tipo | Descripción |
|---|---|---|
data.media | object | Imágenes, videos, audios, título, miniatura y duración normalizados. |
data.platformDataVersion | string | Versión pública del contrato de datos de RedNote / Xiaohongshu; actualmente 1. |
data.platformData.note_id | string | Identificador público del contenido. Guárdalo como texto para evitar pérdidas de precisión con números grandes. |
data.platformData.title | string | Título, texto o descripción que se muestra públicamente en la publicación solicitada. |
data.platformData.desc | string | Título, texto o descripción que se muestra públicamente en la publicación solicitada. |
data.platformData.type | string | Campo público incluido en la respuesta de la plataforma para el contenido solicitado. |
data.platformData.user | object | Datos públicos del autor de la publicación, sin contactos ni credenciales. |
data.platformData.images_list | array | Imágenes, portadas o elementos del carrusel; el orden coincide con la respuesta de la plataforma. |
data.platformData.video_info_v2 | object | Datos de reproducción, calidad, códec, dimensiones y URL multimedia del video solicitado. |
data.platformData.interact_info | object | Métricas públicas de reproducciones, Me gusta, comentarios, guardados o compartidos. |
data.platformData.native_voice_info | object | Información pública de música, sonido original o pistas de audio independientes. |
Ejemplo real de respuesta
- URL de ejemplo
- https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3
- Endpoint
- /api/v1/platforms/xiaohongshu/parse
- Créditos cobrados
- 10 credits
- Cache
- HIT
- Capturado
- 2026-09-17T05:08:25.822Z
Formato común normalizado
El endpoint común devuelve este mismo objeto multimedia directamente en `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"
}Formato completo de plataforma
El endpoint de plataforma devuelve medios normalizados y el objeto de datos de plataforma depurado.
/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"
}Descarga y uso de proxy
Descarga desde el backend con Referer de Xiaohongshu, User-Agent y Range. Conserva los parámetros de las URL firmadas y vuelve a analizar cuando caduquen.
Límites y comportamiento
No admite perfiles, búsquedas, colecciones, notas privadas o eliminadas ni enlaces cortos que ya hayan caducado.
Solo se admite contenido público. El contenido privado, eliminado, restringido por edad o región, en directo o no disponible puede fallar sin consumir créditos.
Un análisis correcto de RedNote / Xiaohongshu cuesta 10 créditos. Los fallos, enlaces no compatibles, errores de autenticación, permisos, ausencia de medios y fallos externos consumen 0 créditos. X-Credits-Charged devuelve los créditos reales cobrados por la respuesta correcta.
Solución de problemas
- Resuelve el enlace corto y conserva el note_id como texto antes de guardarlo en caché.
- Recorre images[] completo para no perder elementos de una publicación con varias imágenes.
- Vuelve a analizar la nota si una URL multimedia firmada ha caducado.
Preguntas frecuentes
¿Una solicitud fallida consume créditos?
No. Solo se cobran créditos cuando la API devuelve medios descargables.
¿Por qué puede fallar una URL pública válida?
La publicación puede estar eliminada, ser privada, tener restricciones regionales, ser un directo, no contener medios o sufrir una indisponibilidad externa.
Guías relacionadas
- Todas las API por plataforma
- API común normalizada
- Todos los formatos de URL
- Códigos de error
- Descarga de medios
- Autenticación
- Créditos y facturación
Referencia interactiva de la API
Los ejemplos en curl, JavaScript y Python, junto con los esquemas, se generan desde el contrato OpenAPI 3.1 de producción.
El panel «Try it» envía solicitudes directamente a api.easydown.org. El token solo permanece en la memoria de la página y se elimina al recargar.
POST
Probar
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"}API de descarga de videos de Threads
Usa la API de Threads con URL públicas compatibles y recibe videos, imágenes, audio y datos completos sin campos sensibles.
API de descarga de videos de Bilibili
Usa la API de Bilibili (China continental) con URL públicas compatibles y recibe videos, imágenes, audio y datos completos sin campos sensibles.