プラットフォーム別動画API
Xiaohongshu / RedNote 動画・画像ダウンロード API
RedNote / Xiaohongshu（小紅書）の対応する公開URLを解析し、ダウンロード可能な動画・画像・音声と、機密項目を除去したプラットフォームデータを取得します。URL形式、レスポンス項目、エラー、実装例を掲載しています。
xhslink.com と xhslink.cn の共有 URL をノート処理前に解決し、投稿メディアだけをマッピングして作者アバターを画像一覧に混在させません。
RedNoteとXiaohongshu（小紅書）の動画ダウンロードに対応し、記載された短縮URLも処理できます。
安定したダウンロードメディアに加えてプラットフォーム固有項目が必要な場合に使用します。
エンドポイント
POST https://api.easydown.org/api/v1/platforms/xiaohongshu/parse
対応URL形式
xiaohongshu.com/explore/{id}xiaohongshu.com/discovery/item/{id}rednote.com/explore/{id}xhslink.com/{path}xhslink.cn/{path}
利用可能な例
https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3https://www.xiaohongshu.com/explore/671e2c6500000000210016b9https://www.rednote.com/explore/6a51ee42000000001702879fhttp://xhslink.com/o/2CxGwu8nSPx
このプラットフォームのレスポンス内容
画像ノートは全コンテンツ画像と first-frame 候補を、動画ノートは動画と関連画像を元の順序で返します。
公開済みプラットフォームデータ項目
対象投稿の最終レスポンスに含まれるその他の公開項目も、機密情報を再帰的に除去したうえで保持します。以下の項目は現在の platformDataVersion 内で安定しています。
| 項目 | 型 | 説明 |
|---|---|---|
data.media | object | 正規化された画像、動画、音声、タイトル、サムネイル、再生時間。 |
data.platformDataVersion | string | RedNote / Xiaohongshu（小紅書）の公開データ契約バージョン。現在は1です。 |
data.platformData.note_id | string | 対象投稿の公開識別子です。大きな数値の精度を失わないよう文字列として保存します。 |
data.platformData.title | string | 対象投稿に公開表示されるタイトル、本文、説明です。 |
data.platformData.desc | string | 対象投稿に公開表示されるタイトル、本文、説明です。 |
data.platformData.type | string | 対象投稿のプラットフォームレスポンスに含まれる公開項目です。 |
data.platformData.user | object | 対象投稿の投稿者に関する公開プロフィール項目です。連絡先や認証情報は含みません。 |
data.platformData.images_list | array | 対象投稿の画像、カバー、カルーセル項目です。配列順はプラットフォームの返却順を維持します。 |
data.platformData.video_info_v2 | object | 動画の再生候補、画質、コーデック、サイズ、メディアURLに関する情報です。 |
data.platformData.interact_info | object | 再生、いいね、コメント、保存、共有など公開されているエンゲージメント指標です。 |
data.platformData.native_voice_info | object | 対象投稿で公開されている楽曲、オリジナル音声、分離音声の情報です。 |
実レスポンス例
- サンプルURL
- https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3
- Endpoint
- /api/v1/platforms/xiaohongshu/parse
- 消費 credits
- 10 credits
- Cache
- 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"
}ダウンロードとプロキシの注意点
Xiaohongshu Referer とブラウザー User-Agent を付けてバックエンド取得します。CDN のリファラー、Cookie、期限、地域制限に注意します。
制限と動作
プロフィール、検索、コレクション、非公開・削除済みノート、ログイン限定、地域で利用できない内容には対応しません。
公開コンテンツのみ対象です。非公開、削除済み、年齢・地域制限、ライブ配信、その他利用できないコンテンツは解析に失敗する場合があります。失敗時にクレジットは消費されません。
RedNote / Xiaohongshu（小紅書） の成功解析は 10 credits です。失敗、非対応、認証失敗、権限エラー、メディアなし、外部サービス障害のレスポンスは 0 credits です。 X-Credits-Charged は成功レスポンスで実際に消費した credits を返します。
トラブルシューティング
- 公開ページに必要なアクセスパラメータを含む完全な URL を保持します。
- ブラウザーから CDN を直接呼ばずバックエンドでプロキシします。
- 短縮 URL やメディア URL が期限切れなら再解析します。
よくある質問
失敗したリクエストは課金されますか？
いいえ。ダウンロード可能なメディアを返した場合のみ、プラットフォーム別 credits を消費します。
正しい公開URLでも失敗するのはなぜですか？
投稿が削除済み、非公開、地域制限、ライブ、メディアなし、または外部サービスが一時的に利用できない可能性があります。
関連ガイド
対話型APIリファレンス
以下のcurl、JavaScript、Pythonの例とスキーマは、本番環境のOpenAPI 3.1契約から生成されます。
「Try it」パネルはapi.easydown.orgへ直接リクエストします。トークンはページのメモリだけに保持され、再読み込みすると消去されます。
POST
試してみる
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"}