视频下载 API 文档

EasyDown REST API 平台指南

Instagram 下载 API:Reels、视频与图片

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

使用 EasyDown Instagram 下载 API 解析公开 Reels、视频、图片和图集,获得完整图片、视频、封面与元数据数组。

Instagram 视频下载 API · Instagram Reels 下载 API

生产环境 REST Endpoint

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

支持的公开 URL 格式

instagram.com/p/{code}instagram.com/reel/{code}instagram.com/reels/{code}instagram.com/share/...

真实请求示例

https://www.instagram.com/reel/DY2PcmxiBE2/

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.instagram.com/reel/DY2PcmxiBE2/"}'

平台专属响应示例

统一响应外层保持稳定;具体平台决定哪些媒体数组和属性会被填充。

媒体返回行为

混合或图集帖子可能同时返回 images[] 与 videos[];封面和缩略图候选会与可下载的帖子媒体分开保留。

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

媒体下载与代理规则

建议后端携带 Instagram Referer 和浏览器 User-Agent 请求。Instagram CDN 可能检查 CORS、CORP、Cookie 或过期签名,浏览器直连并不稳定。

建议的后端请求头

User-Agent: Mozilla/5.0 Referer: https://www.instagram.com/ Origin: https://www.instagram.com/ Range: bytes=0-

不支持或不可用的内容

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

只处理你有权使用的公开媒体。EasyDown 不绕过隐私设置、DRM、已删除内容或平台访问限制。

平台专属排错

提交完整公开帖子或 Reel URL,不要提交账号主页。

浏览器出现 CORS 或 CORP 时,通过后端代理 CDN 媒体。

Instagram CDN URL 过期后重新解析帖子。

REST 集成流程

  1. 1

    创建私有 API Token,并在权限中允许该平台。

  2. 2

    把一个完整的公开作品 URL POST 到统一 Endpoint。

  3. 3

    从 images、videos、audios 中选择所需媒体并通过后端代理。

下载 API 常见问题

Instagram 下载 API 支持哪些 URL?

支持的公开单条作品格式包括 instagram.com/p/{code}, instagram.com/reel/{code}, instagram.com/reels/{code}, instagram.com/share/...。不支持主页、Highlights、Explore、私信、私密帖子、仅登录可见媒体和已过期 Stories。

Instagram 下载 API 会返回哪些媒体?

混合或图集帖子可能同时返回 images[] 与 videos[];封面和缩略图候选会与可下载的帖子媒体分开保留。

应用应该如何下载返回的 Instagram 媒体 URL?

建议后端携带 Instagram Referer 和浏览器 User-Agent 请求。Instagram CDN 可能检查 CORS、CORP、Cookie 或过期签名,浏览器直连并不稳定。

Instagram API 成功请求如何扣费?

成功返回至少一条图片、视频或音频 URL 时扣 1 credit;失败、不支持、鉴权错误和空媒体结果不扣 credits。