動画ダウンロード API ドキュメント

EasyDown REST API プラットフォームガイド

Xiaohongshu / RedNote メディアダウンロード API

共有短縮 URL をノート処理前に解決し、投稿メディアだけをマッピングして作者アバターを画像一覧に混在させません。

認証付き Xiaohongshu / RedNote メディアダウンロード API で公開動画・画像ノートを解析し、画像、動画、first frame、カバー候補を保持します。

RedNote 動画取得 API · 小紅書 画像 API

本番 REST Endpoint

POST https://api.easydown.org/api/v1/parse

対応する公開 URL 形式

xhslink.com/{code}xiaohongshu.com/explore/{noteId}xiaohongshu.com/discovery/item/{noteId}rednote.com/explore/{noteId}

実際のリクエスト例

https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3?source=webshare&xhsshare=pc_web&xsec_token=ABUzYYSiMJkyRD5slTtuDPFvfSOmaGPxm2X4Unms9L1FY=&xsec_source=pc_share

curl -X POST https://api.easydown.org/api/v1/parse \
  -H "Authorization: Bearer ed_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3?source=webshare&xhsshare=pc_web&xsec_token=ABUzYYSiMJkyRD5slTtuDPFvfSOmaGPxm2X4Unms9L1FY=&xsec_source=pc_share"}'

プラットフォーム固有レスポンス例

共通レスポンス外形は一定で、プラットフォームに応じてメディア配列と属性が入ります。

メディアの返却動作

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

{
  "status": 200,
  "data": {
    "platform": "xiaohongshu",
    "title": "Example xiaohongshu public post",
    "thumbnail": "https://cdn.example.com/thumbnail.jpg",
    "duration": 24,
    "images": [
      {
        "url": "https://cdn.example.com/content-image.jpg",
        "width": 1080,
        "height": 1350
      }
    ],
    "videos": [
      {
        "url": "https://cdn.example.com/video.mp4",
        "quality": "HD",
        "mimeType": "video/mp4",
        "width": 1080,
        "height": 1920,
        "hasAudio": true,
        "source": "direct"
      }
    ],
    "audios": []
  },
  "msg": "success"
}

ダウンロードとプロキシ規則

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

推奨バックエンドリクエストヘッダー

User-Agent: Mozilla/5.0 Referer: https://www.xiaohongshu.com/ Range: bytes=0-

非対応・利用できない内容

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

利用権限のある公開メディアだけを処理してください。EasyDown はプライバシー設定、DRM、削除済みコンテンツ、プラットフォーム制限を回避しません。

プラットフォーム固有のトラブル対処

公開ページに必要なアクセスパラメータを含む完全な URL を保持します。

ブラウザーから CDN を直接呼ばずバックエンドでプロキシします。

短縮 URL やメディア URL が期限切れなら再解析します。

REST 連携フロー

  1. 1

    Private API Token を作成し、このプラットフォームを権限で許可します。

  2. 2

    完全な公開投稿 URL を共通 Endpoint に POST します。

  3. 3

    images、videos、audios から必要項目を選びバックエンド経由で取得します。

Download API に関する質問

Xiaohongshu / RedNote Download API はどの URL に対応しますか?

対応する公開単体投稿形式は xhslink.com/{code}, xiaohongshu.com/explore/{noteId}, xiaohongshu.com/discovery/item/{noteId}, rednote.com/explore/{noteId} です。プロフィール、検索、コレクション、非公開・削除済みノート、ログイン限定、地域で利用できない内容には対応しません。

Xiaohongshu / RedNote Download API はどのメディアを返しますか?

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

返された Xiaohongshu / RedNote メディア URL はどう取得しますか?

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

Xiaohongshu / RedNote API の課金方法は?

画像、動画、音声 URL を一件以上返した成功リクエストは 1 credit です。失敗、非対応、認証エラー、空結果は課金されません。