Instagram 视频与图片下载 API

使用 Instagram 视频下载 API 解析已支持的公开链接，返回视频、图片、音频和清理敏感字段后的平台全量数据。

一个 REST 请求即可处理帖子、Reel、embed 和分享链接，并保留图集顺序，方便集成展示或保存完整公开帖子。

适合增加 Instagram 视频下载能力，处理已支持的公开帖子、Reels 和分享链接。

当你既需要稳定的可下载媒体，又需要平台专属字段时，使用此接口。

接口地址

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/3940061275140997661
https://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`	目标作品的视频播放、清晰度、编码、尺寸和媒体地址信息。
`data.platformData.image_versions`	`object`	目标作品的图片、封面或图集项目；数组顺序与平台返回顺序一致。
`data.platformData.carousel_media`	`array`	目标作品的图片、封面或图集项目；数组顺序与平台返回顺序一致。
`data.platformData.taken_at`	`number`	目标作品在平台响应中的公开字段。

真实调用样例

示例链接: https://www.instagram.com/reel/DY2PcmxiBE2/
Endpoint: /api/v1/platforms/instagram/parse
本次扣费: 1 credits
缓存: HIT
采集时间: 2026-09-17T05:08:21.111Z

通用格式

通用接口会把同一个媒体对象直接放在 `data` 中返回。

/api/v1/parse response

{
  "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"
}

平台完整格式

平台专用接口会同时返回通用媒体结构和清理后的平台完整数据。

/api/v1/platforms/instagram/parse

{
  "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 请求。Instagram CDN 可能检查 CORS、CORP、Cookie 或过期签名，浏览器直连并不稳定。

限制与行为

不支持主页、Highlights、Explore、私信、私密帖子、仅登录可见媒体和已过期 Stories。

仅支持公开内容。私密、已删除、年龄限制、地区限制、直播或其他不可用内容可能解析失败，失败不消耗额度。

Instagram 成功解析一次扣 1 credits。失败、不支持、鉴权失败、权限错误、无媒体和上游故障响应均扣 0 credits。 X-Credits-Charged 会返回本次成功响应实际扣除的 credits。

故障排查

提交完整公开帖子或 Reel URL，不要提交账号主页。
浏览器出现 CORS 或 CORP 时，通过后端代理 CDN 媒体。
Instagram CDN URL 过期后重新解析帖子。

常见问题

失败请求会消耗额度吗？

不会。只有 API 成功返回可下载媒体后才按平台费率扣 credits。

为什么有效的公开链接仍可能失败？

作品可能已经删除、设为私密、存在地区限制、属于直播、没有可下载媒体，或上游服务暂时不可用。

交互式 API 参考

下方 curl、JavaScript、Python 示例和接口模式定义均由生产 OpenAPI 3.1 契约生成。

在线调试面板会直接请求 api.easydown.org。Token 只保存在当前页面内存中，刷新后立即清除。

POST

在线调试

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

url?string

Public media URL to parse

Formaturi

link?string

Compatibility alias for url

Length1 <= length

Response Body

`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"}

Instagram 视频与图片下载 API

接口地址

支持的 URL 格式

可用示例

该平台响应会返回什么

已发布的平台数据字段

真实调用样例

通用格式

平台完整格式

下载与代理建议

限制与行为

故障排查

常见问题

失败请求会消耗额度吗？

为什么有效的公开链接仍可能失败？

相关指南

交互式 API 参考

在线调试

Authorization

Request Body

Response Body

`application/json`

`application/json`

`application/json`

On this page

Instagram 视频与图片下载 API

真实调用样例

通用格式

平台完整格式

在线调试

200application/json

4XXapplication/json

5XXapplication/json

On this page

`application/json`

`application/json`

`application/json`