EasyDown API Docs
各平台视频下载 API

小红书 / 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/67f75b07000000000b0154b3
  • https://www.xiaohongshu.com/explore/671e2c6500000000210016b9
  • https://www.rednote.com/explore/6a51ee42000000001702879f
  • http://xhslink.com/o/2CxGwu8nSPx

该平台响应会返回什么

图文笔记返回全部内容图片和首帧候选;视频笔记返回映射后的视频及相关作品图片,并保持源顺序。

已发布的平台数据字段

接口会保留目标作品最终响应中的其他公开字段,并递归删除敏感字段。下表字段在当前 platformDataVersion 内保持稳定。

字段类型说明
data.mediaobject统一的图片、视频、音频、标题、封面和时长。
data.platformDataVersionstring小红书 / RedNote的公开数据契约版本,当前为 1
data.platformData.note_idstring目标作品在平台中的公开标识,请按字符串保存以避免大整数精度丢失。
data.platformData.titlestring目标作品公开展示的标题、正文或说明文字。
data.platformData.descstring目标作品公开展示的标题、正文或说明文字。
data.platformData.typestring目标作品在平台响应中的公开字段。
data.platformData.userobject目标作品作者的公开资料字段,不包含联系方式或鉴权信息。
data.platformData.images_listarray目标作品的图片、封面或图集项目;数组顺序与平台返回顺序一致。
data.platformData.video_info_v2object目标作品的视频播放、清晰度、编码、尺寸和媒体地址信息。
data.platformData.interact_infoobject平台公开展示的播放、点赞、评论、收藏或分享等互动统计。
data.platformData.native_voice_infoobject目标作品的公开配乐、原声或独立音轨信息。

真实调用样例

示例链接
https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3
Endpoint
/api/v1/platforms/xiaohongshu/parse
本次扣费
10 credits
缓存
HIT
采集时间
2026-09-17T05:08:25.822Z

通用格式

通用接口会把同一个媒体对象直接放在 `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"
}

平台完整格式

平台专用接口会同时返回通用媒体结构和清理后的平台完整数据。

/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"
}

下载与代理建议

后端请求携带小红书 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 只保存在当前页面内存中,刷新后立即清除。

POST

在线调试

成功返回可下载媒体会按平台费率扣费;失败请求不扣费。

Token 仅保存在当前页面内存中,关闭或刷新页面后立即清除。

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"}