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

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

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

上流結果の先頭を使わず shortcode で対象投稿を照合し、共通 REST スキーマで完全な投稿メディアを返します。

EasyDown Threads ダウンロード API で公開メディア投稿を解析し、対象 shortcode の動画バリアント、カルーセル画像、投稿画像、カバーを取得します。

Threads 動画取得 API · Threads メディア API

本番 REST Endpoint

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

対応する公開 URL 形式

threads.com/@user/post/{shortcode}threads.net/@user/post/{shortcode}Optional query string or /media suffix

実際のリクエスト例

https://www.threads.com/@eekeai/post/DDhV3LWhrlk

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.threads.com/@eekeai/post/DDhV3LWhrlk"}'

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

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

メディアの返却動作

有効な動画バリアントとカルーセル内の各画像を返し、上流で別候補として提供される重複バリアントも保持する場合があります。

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

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

ブラウザー User-Agent と Threads Referer を付けてバックエンド取得し、署名や候補が変わるため URL は短期間だけ保持します。

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

User-Agent: Mozilla/5.0 Referer: https://www.threads.net/ Range: bytes=0-

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

テキストのみの投稿、プロフィール、フィード、返信、検索、非公開・削除済み投稿はダウンロード可能なメディアを返しません。

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

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

threads.com または threads.net の標準投稿 URL を使用します。

テキストのみの成功レスポンスはメディアなしとして扱います。

先頭だけでなく返されたカルーセル画像をすべて保持します。

REST 連携フロー

  1. 1

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

  2. 2

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

  3. 3

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

Download API に関する質問

Threads Download API はどの URL に対応しますか?

対応する公開単体投稿形式は threads.com/@user/post/{shortcode}, threads.net/@user/post/{shortcode}, Optional query string or /media suffix です。テキストのみの投稿、プロフィール、フィード、返信、検索、非公開・削除済み投稿はダウンロード可能なメディアを返しません。

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

有効な動画バリアントとカルーセル内の各画像を返し、上流で別候補として提供される重複バリアントも保持する場合があります。

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

ブラウザー User-Agent と Threads Referer を付けてバックエンド取得し、署名や候補が変わるため URL は短期間だけ保持します。

Threads API の課金方法は?

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