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

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

Twitter / X 動画ダウンロード API

x.com と twitter.com の status URL を同じ REST フローで処理し、大きな投稿 ID は文字列のまま、全メディア候補を保持します。

EasyDown Twitter / X 動画ダウンロード API で公開 status URL を解析し、動画ビットレート、投稿画像、サムネイル、メタデータを取得します。

Twitter 動画取得 API · X 動画ダウンロード API

API Token を作成API 料金を見るWeb ダウンローダー

本番 REST Endpoint

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

対応する公開 URL 形式

x.com/{user}/status/{id}twitter.com/{user}/status/{id}x.com/i/status/{id}

実際のリクエスト例

https://x.com/Taozhishuishui/status/2041638397358260556/video/1

curl -X POST https://api.easydown.org/api/v1/parse \
  -H "Authorization: Bearer ed_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://x.com/Taozhishuishui/status/2041638397358260556/video/1"}'

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

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

メディアの返却動作

動画投稿では複数ビットレート・サイズを返し、画像投稿ではすべての投稿画像を保持してサムネイルで代用しません。

{
  "status": 200,
  "data": {
    "platform": "twitter",
    "title": "Example twitter 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"
}

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

X Referer とブラウザー User-Agent を付け、Range を転送してバックエンド取得します。選択 URL が期限切れなら再解析します。

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

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

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

プロフィール、検索、Spaces、コミュニティ、Broadcast、非公開・削除済み投稿、CDN 直 URL には対応しません。

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

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

一つの投稿 ID を含む status URL を送信します。

配列位置だけでなく画質とサイズで videos[] を選択します。

メディアが無効になったら元 status を再解析します。

REST 連携フロー

  1. 1

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

  2. 2

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

  3. 3

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

関連プラットフォーム API ドキュメント

YouTube

YouTube 動画ダウンロード API

TikTok

TikTok 動画ダウンロード API

Instagram

Instagram ダウンロード API：リール・動画・写真

Threads

Threads 動画・画像ダウンロード API

Bilibili

Bilibili 動画ダウンロード API

Xiaohongshu / RedNote

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

EasyDown のその他の利用方法

AI Agent では MCP Endpoint、手動の公開メディア処理では Web ツールを利用できます。

プラットフォーム MCP ガイド

Download API に関する質問

Twitter / X Download API はどの URL に対応しますか？

対応する公開単体投稿形式は x.com/{user}/status/{id}, twitter.com/{user}/status/{id}, x.com/i/status/{id} です。プロフィール、検索、Spaces、コミュニティ、Broadcast、非公開・削除済み投稿、CDN 直 URL には対応しません。

Twitter / X Download API はどのメディアを返しますか？

動画投稿では複数ビットレート・サイズを返し、画像投稿ではすべての投稿画像を保持してサムネイルで代用しません。

返された Twitter / X メディア URL はどう取得しますか？

X Referer とブラウザー User-Agent を付け、Range を転送してバックエンド取得します。選択 URL が期限切れなら再解析します。

Twitter / X API の課金方法は？

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