Instagram 動画・画像ダウンロード API
Instagramの対応する公開URLを解析し、ダウンロード可能な動画・画像・音声と、機密項目を除去したプラットフォームデータを取得します。URL形式、レスポンス項目、エラー、実装例を掲載しています。
一つの REST リクエストで投稿、リール、embed、共有 URL を処理し、カルーセル順序を維持して公開投稿全体を利用できます。
対応する公開投稿、リール、共有URLからInstagram動画を保存・ダウンロードする機能に適しています。
安定したダウンロードメディアに加えてプラットフォーム固有項目が必要な場合に使用します。
エンドポイント
POST https://api.easydown.org/api/v1/platforms/instagram/parse
対応URL形式
instagram.com/reel/{id}instagram.com/p/{id}instagram.com/stories/{user}/{id}instagram.com/share/{type}/{code}
利用可能な例
https://www.instagram.com/reel/DY2PcmxiBE2/https://www.instagram.com/p/DYJIhddkzi0/https://www.instagram.com/stories/wordongreene/3940061275140997661https://www.instagram.com/share/reel/BAabcdef123/
このプラットフォームのレスポンス内容
混合・カルーセル投稿では images[] と videos[] の両方を返し、カバーやサムネイル候補は投稿メディアと分けて保持します。
公開済みプラットフォームデータ項目
対象投稿の最終レスポンスに含まれるその他の公開項目も、機密情報を再帰的に除去したうえで保持します。以下の項目は現在の platformDataVersion 内で安定しています。
| 項目 | 型 | 説明 |
|---|---|---|
data.media | object | 正規化された画像、動画、音声、タイトル、サムネイル、再生時間。 |
data.platformDataVersion | string | Instagramの公開データ契約バージョン。現在は1です。 |
data.platformData.id | string | 対象投稿の公開識別子です。大きな数値の精度を失わないよう文字列として保存します。 |
data.platformData.code | string | 対象投稿の公開識別子です。大きな数値の精度を失わないよう文字列として保存します。 |
data.platformData.caption | object | 対象投稿に公開表示されるタイトル、本文、説明です。 |
data.platformData.user | object | 対象投稿の投稿者に関する公開プロフィール項目です。連絡先や認証情報は含みません。 |
data.platformData.video_versions | array | 動画の再生候補、画質、コーデック、サイズ、メディアURLに関する情報です。 |
data.platformData.image_versions | object | 対象投稿の画像、カバー、カルーセル項目です。配列順はプラットフォームの返却順を維持します。 |
data.platformData.carousel_media | array | 対象投稿の画像、カバー、カルーセル項目です。配列順はプラットフォームの返却順を維持します。 |
data.platformData.taken_at | number | 対象投稿のプラットフォームレスポンスに含まれる公開項目です。 |
実レスポンス例
- サンプルURL
- https://www.instagram.com/reel/DY2PcmxiBE2/
- Endpoint
- /api/v1/platforms/instagram/parse
- 消費 credits
- 1 credits
- Cache
- HIT
- 取得日時
- 2026-09-17T05:08:21.111Z
共通の正規化形式
共通エンドポイントでは、このメディアオブジェクトがそのまま `data` に入ります。
{
"status": 200,
"data": {
"platform": "instagram",
"title": "Tonight, @thv took a turn in the audience as he watched @gracieabrams and @dojacat perform at #VogueWorld: Hollywood. No stranger to a fashion show either, the @bts.bighitofficial star dressed in a look that could have easily appeared on the runway",
"thumbnail": "https://instagram.fsvq6-1.fna.fbcdn.net/v/t51.82787-15/705502004_18102182545917416_104266069802266630_n.jpg?stp=c0.210.540.540a_dst-jpg_e15_tt6&_nc_ht=instagram.fsvq6-1.fna.fbcdn.net&_nc_cat=108&_nc_oc=Q6cZ2gGrkS-iHUP2Kd0pOvjvF4ziF5_E48jL5fVHqUwH749eLaD_D1kJayW9_VX4-iglEnA&_nc_ohc=TOJ169m3MvoQ7kNvwGuw-4V&_nc_gid=hmmdPt-hfGixkFZa04wkyQ&edm=AOmX9WgBAAAA&ccb=7-5&oh=00_AQIzbKKGDaavNtZPc377OCNK0q7uLWOIp5VJFs2mgTySSQ&oe=6AB13650&_nc_sid=bfaa47",
"duration": 0,
"images": [],
"videos": [
{
"url": "https://instagram.fsvq6-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQP1D_mBT9HQhdl6TOGFigwTFm3NuKWTUhtogOgmbGl2UoA3-JoPEDwkCntXMyDbrno5OF5Uo8k5Uujmzp0Ra4Mr4gvxZYSmdMr3W30.mp4?_nc_cat=102&_nc_oc=AdozSyAH3l78vzdBPCusk9ngKFV5pHToNVNv53BGQQgg1ZEDm7bSolTK-058RN7qAWM&_nc_sid=5e9851&_nc_ht=instagram.fsvq6-1.fna.fbcdn.net&_nc_ohc=GaV2Je9qZhAQ7kNvwFW1Qbo&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNTc2LmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjEzMDk3NzMyMTA4MzgyOCwiYXNzZXRfYWdlX2RheXMiOjExMiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=137ae71a79f39cba&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC85QzQ2RjIzQ0ExOUQxQjZFOTk4NEFCMTA2NENGN0NCRV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0Y5NEQwMDUxNUNGNUE1Qjg5OEZFNjI2QzIwNDIyOUJEX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbojvujmofJBxUCKAJDMywXQC8AAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=hmmdPt-hfGixkFZa04wkyQ&_nc_ss=7a3ba&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQK2MFty36fMJywWFT90r5i3YUrMlXHxWg2Z-F1Mlh0ExA&oe=6AAD4BD7",
"quality": "Video",
"mimeType": "video/mp4",
"width": 0,
"height": 0,
"hasAudio": true,
"source": "direct",
"headers": {}
}
],
"audios": []
},
"msg": "success"
}プラットフォーム完全データ形式
プラットフォーム別エンドポイントでは、正規化メディアとサニタイズ済みプラットフォームデータを返します。
{
"status": 200,
"data": {
"media": {
"platform": "instagram",
"title": "Tonight, @thv took a turn in the audience as he watched @gracieabrams and @dojacat perform at #VogueWorld: Hollywood. No stranger to a fashion show either, the @bts.bighitofficial star dressed in a look that could have easily appeared on the runway",
"thumbnail": "https://instagram.fsvq6-1.fna.fbcdn.net/v/t51.82787-15/705502004_18102182545917416_104266069802266630_n.jpg?stp=c0.210.540.540a_dst-jpg_e15_tt6&_nc_ht=instagram.fsvq6-1.fna.fbcdn.net&_nc_cat=108&_nc_oc=Q6cZ2gGrkS-iHUP2Kd0pOvjvF4ziF5_E48jL5fVHqUwH749eLaD_D1kJayW9_VX4-iglEnA&_nc_ohc=TOJ169m3MvoQ7kNvwGuw-4V&_nc_gid=hmmdPt-hfGixkFZa04wkyQ&edm=AOmX9WgBAAAA&ccb=7-5&oh=00_AQIzbKKGDaavNtZPc377OCNK0q7uLWOIp5VJFs2mgTySSQ&oe=6AB13650&_nc_sid=bfaa47",
"duration": 0,
"images": [],
"videos": [
{
"url": "https://instagram.fsvq6-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQP1D_mBT9HQhdl6TOGFigwTFm3NuKWTUhtogOgmbGl2UoA3-JoPEDwkCntXMyDbrno5OF5Uo8k5Uujmzp0Ra4Mr4gvxZYSmdMr3W30.mp4?_nc_cat=102&_nc_oc=AdozSyAH3l78vzdBPCusk9ngKFV5pHToNVNv53BGQQgg1ZEDm7bSolTK-058RN7qAWM&_nc_sid=5e9851&_nc_ht=instagram.fsvq6-1.fna.fbcdn.net&_nc_ohc=GaV2Je9qZhAQ7kNvwFW1Qbo&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNTc2LmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjEzMDk3NzMyMTA4MzgyOCwiYXNzZXRfYWdlX2RheXMiOjExMiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=137ae71a79f39cba&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC85QzQ2RjIzQ0ExOUQxQjZFOTk4NEFCMTA2NENGN0NCRV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0Y5NEQwMDUxNUNGNUE1Qjg5OEZFNjI2QzIwNDIyOUJEX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbojvujmofJBxUCKAJDMywXQC8AAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=hmmdPt-hfGixkFZa04wkyQ&_nc_ss=7a3ba&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQK2MFty36fMJywWFT90r5i3YUrMlXHxWg2Z-F1Mlh0ExA&oe=6AAD4BD7",
"quality": "Video",
"mimeType": "video/mp4",
"width": 0,
"height": 0,
"hasAudio": true,
"source": "direct",
"headers": {}
}
],
"audios": []
},
"platformData": {
"data": {
"full_name": "jnmarcusx",
"username": "jnmarcusx",
"medias": [
{
"type": "video",
"link": "https://instagram.fsvq6-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQP1D_mBT9HQhdl6TOGFigwTFm3NuKWTUhtogOgmbGl2UoA3-JoPEDwkCntXMyDbrno5OF5Uo8k5Uujmzp0Ra4Mr4gvxZYSmdMr3W30.mp4?_nc_cat=102&_nc_oc=AdozSyAH3l78vzdBPCusk9ngKFV5pHToNVNv53BGQQgg1ZEDm7bSolTK-058RN7qAWM&_nc_sid=5e9851&_nc_ht=instagram.fsvq6-1.fna.fbcdn.net&_nc_ohc=GaV2Je9qZhAQ7kNvwFW1Qbo&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNTc2LmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjEzMDk3NzMyMTA4MzgyOCwiYXNzZXRfYWdlX2RheXMiOjExMiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=137ae71a79f39cba&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC85QzQ2RjIzQ0ExOUQxQjZFOTk4NEFCMTA2NENGN0NCRV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0Y5NEQwMDUxNUNGNUE1Qjg5OEZFNjI2QzIwNDIyOUJEX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbojvujmofJBxUCKAJDMywXQC8AAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=hmmdPt-hfGixkFZa04wkyQ&_nc_ss=7a3ba&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQK2MFty36fMJywWFT90r5i3YUrMlXHxWg2Z-F1Mlh0ExA&oe=6AAD4BD7",
"img": "https://instagram.fsvq6-1.fna.fbcdn.net/v/t51.82787-15/705502004_18102182545917416_104266069802266630_n.jpg?stp=c0.210.540.540a_dst-jpg_e15_tt6&_nc_ht=instagram.fsvq6-1.fna.fbcdn.net&_nc_cat=108&_nc_oc=Q6cZ2gGrkS-iHUP2Kd0pOvjvF4ziF5_E48jL5fVHqUwH749eLaD_D1kJayW9_VX4-iglEnA&_nc_ohc=TOJ169m3MvoQ7kNvwGuw-4V&_nc_gid=hmmdPt-hfGixkFZa04wkyQ&edm=AOmX9WgBAAAA&ccb=7-5&oh=00_AQIzbKKGDaavNtZPc377OCNK0q7uLWOIp5VJFs2mgTySSQ&oe=6AB13650&_nc_sid=bfaa47"
}
],
"comment_count": 1177,
"like_count": 326169,
"taken_at_timestamp": 1779896570,
"caption": "Tonight, @thv took a turn in the audience as he watched @gracieabrams and @dojacat perform at #VogueWorld: Hollywood. No stranger to a fashion show either, the @bts.bighitofficial star dressed in a look that could have easily appeared on the runway"
},
"status": true,
"attempts": "37"
},
"platformDataVersion": "1"
},
"msg": "success"
}ダウンロードとプロキシの注意点
Instagram Referer とブラウザー User-Agent を付けてバックエンドから取得します。CDN の CORS、CORP、Cookie、期限付き署名によりブラウザー直アクセスは不安定です。
制限と動作
プロフィール、ハイライト、Explore、DM、非公開・ログイン限定投稿、期限切れ Stories には対応しません。
公開コンテンツのみ対象です。非公開、削除済み、年齢・地域制限、ライブ配信、その他利用できないコンテンツは解析に失敗する場合があります。失敗時にクレジットは消費されません。
Instagram の成功解析は 1 credits です。失敗、非対応、認証失敗、権限エラー、メディアなし、外部サービス障害のレスポンスは 0 credits です。 X-Credits-Charged は成功レスポンスで実際に消費した credits を返します。
トラブルシューティング
- アカウントではなく完全な公開投稿・リール URL を送信します。
- CORS/CORP の場合は CDN メディアをバックエンド経由で取得します。
- Instagram CDN URL が期限切れになったら投稿を再解析します。
よくある質問
失敗したリクエストは課金されますか?
いいえ。ダウンロード可能なメディアを返した場合のみ、プラットフォーム別 credits を消費します。
正しい公開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/instagram/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", "caption": {}, "user": {}, "video_versions": [ null ], "image_versions": {}, "carousel_media": [ null ], "taken_at": 0 }, "platformDataVersion": "1" }, "msg": "success"}