Xiaohongshu / RedNote 動画・画像ダウンロード API

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

このプラットフォームのレスポンス内容

画像ノートは全コンテンツ画像と first-frame 候補を、動画ノートは動画と関連画像を元の順序で返します。

公開済みプラットフォームデータ項目

対象投稿の最終レスポンスに含まれるその他の公開項目も、機密情報を再帰的に除去したうえで保持します。以下の項目は現在の platformDataVersion 内で安定しています。

{
  "status": 200,
  "data": {
    "media": {
      "platform": "xiaohongshu",
      "title": "公開投稿の例",
      "thumbnail": "https://public-cdn.example/cover.jpg",
      "duration": 18,
      "images": [],
      "videos": [
        {
          "url": "https://public-cdn.example/video.mp4",
          "quality": "1080p",
          "mimeType": "video/mp4",
          "width": 1920,
          "height": 1080,
          "hasAudio": true,
          "source": "direct"
        }
      ],
      "audios": []
    },
    "platformData": {
      "note_id": "67f75b07000000000b0154b3",
      "title": "Example public RedNote post",
      "desc": "Example note description",
      "type": "video",
      "user": {
        "user_id": "creator-id",
        "nickname": "Example creator"
      },
      "images_list": [
        {
          "width": 1080,
          "height": 1440,
          "url": "https://media.example/image.jpg"
        }
      ],
      "interact_info": {
        "liked_count": "120",
        "collected_count": "24"
      }
    },
    "platformDataVersion": "1"
  },
  "msg": "success"
}

ダウンロードとプロキシの注意点

Xiaohongshu Referer とブラウザー User-Agent を付けてバックエンド取得します。CDN のリファラー、Cookie、期限、地域制限に注意します。

制限と動作

プロフィール、検索、コレクション、非公開・削除済みノート、ログイン限定、地域で利用できない内容には対応しません。

公開コンテンツのみ対象です。非公開、削除済み、年齢・地域制限、ライブ配信、その他利用できないコンテンツは解析に失敗する場合があります。失敗時にクレジットは消費されません。

ダウンロード可能なメディアを返した場合のみ1クレジットを消費します。認証、入力検証、権限、コンテンツ利用不可、メディアなし、外部サービス障害は課金されません。

トラブルシューティング

• 公開ページに必要なアクセスパラメータを含む完全な URL を保持します。
• ブラウザーから CDN を直接呼ばずバックエンドでプロキシします。
• 短縮 URL やメディア URL が期限切れなら再解析します。

よくある質問

失敗したリクエストは課金されますか？

いいえ。ダウンロード可能なメディアを返した場合のみ1クレジットを消費します。

正しい公開URLでも失敗するのはなぜですか？

投稿が削除済み、非公開、地域制限、ライブ、メディアなし、または外部サービスが一時的に利用できない可能性があります。

関連ガイド

• 全プラットフォームAPI
• 共通の正規化API
• 対応する全URL形式
• エラーコード
• メディアのダウンロード
• API認証
• 料金とクレジット

対話型APIリファレンス

以下のcurl、JavaScript、Pythonの例とスキーマは、本番環境のOpenAPI 3.1契約から生成されます。

「Try it」パネルはapi.easydown.orgへ直接リクエストします。トークンはページのメモリだけに保持され、再読み込みすると消去されます。

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