AgentBodyAgentBody
登录

Instagram Video Download API

一次带鉴权的 GET 请求，以干净的 JSON 返回公开 Instagram 帖子的 URL、文案、创作者和互动数据——可直接用于下载类工作流和数据管道。

  • 单一 REST 端点
  • URL 或帖子 ID 输入
  • 结构化 JSON 输出
  • 帖子与创作者上下文
  • 可预期的错误码
  • 五种语言示例
工具API

请求示例

查看 API 文档 完整 API 文档 
curl "https://api.agentbody.io/v1/instagram/post?post_id=1234567890123456789&url=https%3A%2F%2Fwww.instagram.com%2Fp%2FDcLs3w6GZGH%2F" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>"

响应示例

来自 OpenAPI 规范的已文档化响应。

Successful Gateway result.

{
  "id": "example_id"
}

功能特点

使用 Instagram Video Download API 获取公开帖子详情——URL、文案、创作者和互动数据——服务于下载类产品、调研管道和内容监测。

单一 REST 端点

带上 Bearer API Key 和公开帖子 URL 或帖子 ID，调用 GET /v1/instagram/post。Instagram 视频下载 API 通过一次文档化的 HTTP 请求返回帖子详情，应用无需维护浏览器驱动爬虫或非官方客户端 SDK。

URL 或帖子 ID 输入

直接提交公开帖子 URL，或从中提取的帖子 ID——取决于你的管道手里有什么。两者都解析为同一份结构化响应，集成时可以直接接受用户提供的链接，省去单独的解析步骤。

结构化 JSON 输出

在可预期的 JSON 响应中接收 id、url、name、text、username、media_type、created_at，以及含播放、点赞、评论、分享计数的 metrics 对象。适合存储帖子记录、构建合集或输送下游分析管道。

帖子与创作者上下文

每个响应都把帖子 URL 与其文案、创作者用户名和发布日期配对返回。下载工作流、存档系统和调研工具拿到的是一份完整可引用的公开帖子记录，而不是没有上下文的裸链接。

可预期的错误码

以文档化状态码处理失败：400 请求无效、401 缺失或错误 API Key、402 余额不足、502/503/504 暂时性上游问题。每个响应都能标识问题类别，重试与告警逻辑保持简单。

五种语言示例

本页请求示例直接从该 API 的 OpenAPI 定义生成，覆盖 curl、JavaScript、Python、Java 和 Go。直接采用你的技术栈已有的语言和 HTTP 客户端，集成就是一次标准的带鉴权 GET。

使用步骤

按以下六步调用 Instagram Video Download API：传入公开帖子 URL 或 ID，处理返回的详情。

01

创建 API Key

创建 AgentBody 账号并在控制台生成 API Key。把 Key 保存在服务器环境或经批准的密钥存储中，以 Bearer Token 发送。绝不要把有效 Key 放进浏览器代码、公开仓库或客户端包。

02

选择公开帖子

选定需要的公开 Instagram 视频/Reel，复制其 URL 或提取帖子 ID。私密帖子、已删除帖子和快拍无法解析——需要覆盖时请准备替代来源。

03

构造 GET 请求

向 /v1/instagram/post 发送带鉴权的 GET 请求，附上 url 或 post_id 查询参数。本页生成的示例展示了 curl、JavaScript、Python、Java 和 Go 的完整请求，可直接匹配你的服务正在使用的 HTTP 客户端。

04

Key 只留在服务端

从后端、Serverless 函数或定时任务调用该端点——任何 API Key 不会暴露给浏览器的位置。如果向最终用户提供查询能力，请通过你自己的端点代理，让 Key 和计费始终在你的控制之下。

05

解析 JSON 响应

读取返回的 id、url、name、text、username、media_type、created_at 和 metrics 字段。只存储产品需要的字段，让帖子 URL 与创作者、文案上下文配对留存，数据保留策略与你的隐私政策对齐。

06

正确处理错误

400 修正请求，401 配置有效 Key，402 补足余额。502、503、504 表示暂时性上游问题，应带退避地重试——它们不代表帖子本身永久失效。

常见问题

Instagram Video Download API 是什么？

Instagram Video Download API 是带鉴权的 GET 端点 /v1/instagram/post，以结构化 JSON 返回公开 Instagram 帖子的详情——URL、文案、创作者用户名、发布日期、媒体类型和互动数据。带上公开帖子 URL 或帖子 ID 和 Bearer API Key 发起请求，即可在应用中处理响应。

有免费的 Instagram 视频下载 API 吗？

可以从免费的 AgentBody 账号开始，每次调用消耗账号额度，正式放量前可以先免费试用。按量价格由网关管理，本页不写死数字，当前的单次成本请在控制台查看。

它能替代 Instagram 下载 API 爬虫方案吗？

在公开帖子详情这件事上可以。无需维护带浏览器自动化、代理池和解析代码的 Instagram 下载爬虫，直接调用一个文档化的 REST 端点就能拿到稳定的 JSON 字段。API 只读取公开数据，不能绕过私密或已删除的帖子。

API 响应包含哪些字段？

成功响应包含 id、url、name、text、username、media_type、created_at，以及含播放、点赞、评论、分享数的 metrics 对象。url 字段即帖子链接，metrics 记录请求时点的互动数据。这些字段可直接用于存储、搜索或分析流程。

API 会返回视频文件或下载链接吗？

返回的是含帖子 URL 的结构化帖子详情——不是重新编码的媒体文件。你的应用处理的是公开帖子记录：链接、创作者、文案和数据。媒体处理（如果有）属于你自己的管道，且须在 Instagram 条款范围内。

API 报错怎么处理？

400 修正请求结构，401 检查 Bearer Key，402 解决余额。502、503、504 按暂时性上游失败处理，带退避重试。重试前记录状态码和错误代码，让管道能区分坏请求与暂时性故障。