Threads 動画・画像ダウンロード API
Threadsの対応する公開URLを解析し、ダウンロード可能な動画・画像・音声と、機密項目を除去したプラットフォームデータを取得します。URL形式、レスポンス項目、エラー、実装例を掲載しています。
上流結果の先頭を使わず shortcode で対象投稿を照合し、共通 REST スキーマで完全な投稿メディアを返します。
リクエストした投稿だけを返すThreads動画ダウンロード機能の実装に適しています。
安定したダウンロードメディアに加えてプラットフォーム固有項目が必要な場合に使用します。
エンドポイント
POST https://api.easydown.org/api/v1/platforms/threads/parse
対応URL形式
threads.com/@{user}/post/{id}threads.net/@{user}/post/{id}threads.com/share/{code}
利用可能な例
https://www.threads.com/@eekeai/post/DDhV3LWhrlkhttps://www.threads.com/share/BAVE8ZDthE/
このプラットフォームのレスポンス内容
有効な動画バリアントとカルーセル内の各画像を返し、上流で別候補として提供される重複バリアントも保持する場合があります。
公開済みプラットフォームデータ項目
対象投稿の最終レスポンスに含まれるその他の公開項目も、機密情報を再帰的に除去したうえで保持します。以下の項目は現在の platformDataVersion 内で安定しています。
| 項目 | 型 | 説明 |
|---|---|---|
data.media | object | 正規化された画像、動画、音声、タイトル、サムネイル、再生時間。 |
data.platformDataVersion | string | Threadsの公開データ契約バージョン。現在は1です。 |
data.platformData.id | string | 対象投稿の公開識別子です。大きな数値の精度を失わないよう文字列として保存します。 |
data.platformData.code | string | 対象投稿の公開識別子です。大きな数値の精度を失わないよう文字列として保存します。 |
data.platformData.text | string | 対象投稿に公開表示されるタイトル、本文、説明です。 |
data.platformData.user | object | 対象投稿の投稿者に関する公開プロフィール項目です。連絡先や認証情報は含みません。 |
data.platformData.images | array | 対象投稿の画像、カバー、カルーセル項目です。配列順はプラットフォームの返却順を維持します。 |
data.platformData.video_versions | array | 動画の再生候補、画質、コーデック、サイズ、メディアURLに関する情報です。 |
data.platformData.carousel_media | array | 対象投稿の画像、カバー、カルーセル項目です。配列順はプラットフォームの返却順を維持します。 |
{
"status": 200,
"data": {
"media": {
"platform": "threads",
"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": {
"id": "example-thread-id",
"code": "DDhV3LWhrlk",
"text": "Example public Threads post",
"user": {
"username": "creator"
},
"images": [
{
"url": "https://media.example/image.jpg",
"width": 1080,
"height": 1350
}
]
},
"platformDataVersion": "1"
},
"msg": "success"
}ダウンロードとプロキシの注意点
ブラウザー User-Agent と Threads Referer を付けてバックエンド取得し、署名や候補が変わるため URL は短期間だけ保持します。
制限と動作
テキストのみの投稿、プロフィール、フィード、返信、検索、非公開・削除済み投稿はダウンロード可能なメディアを返しません。
公開コンテンツのみ対象です。非公開、削除済み、年齢・地域制限、ライブ配信、その他利用できないコンテンツは解析に失敗する場合があります。失敗時にクレジットは消費されません。
ダウンロード可能なメディアを返した場合のみ1クレジットを消費します。認証、入力検証、権限、コンテンツ利用不可、メディアなし、外部サービス障害は課金されません。
トラブルシューティング
- threads.com または threads.net の標準投稿 URL を使用します。
- テキストのみの成功レスポンスはメディアなしとして扱います。
- 先頭だけでなく返されたカルーセル画像をすべて保持します。
よくある質問
失敗したリクエストは課金されますか？
いいえ。ダウンロード可能なメディアを返した場合のみ1クレジットを消費します。
正しい公開URLでも失敗するのはなぜですか？
投稿が削除済み、非公開、地域制限、ライブ、メディアなし、または外部サービスが一時的に利用できない可能性があります。
関連ガイド
対話型APIリファレンス
以下のcurl、JavaScript、Pythonの例とスキーマは、本番環境のOpenAPI 3.1契約から生成されます。
「Try it」パネルはapi.easydown.orgへ直接リクエストします。トークンはページのメモリだけに保持され、再読み込みすると消去されます。
試してみる
Authorization
bearerAuth 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/threads/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": { "id": "string", "code": "string", "text": "string", "user": {}, "images": [ null ], "video_versions": [ null ], "carousel_media": [ null ] }, "platformDataVersion": "1" }, "msg": "success"}