AgentBodyAgentBody
登录

Instagram 帖子下载器 API

一次认证 GET 请求返回公开 Instagram 帖子的 URL、文案、作者和互动数据——支持图片、轮播和视频帖子。

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

请求示例

查看 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 帖子下载器 API 获取公开帖子详情——URL、文案、作者和互动数据——用于下载器类产品、研究管道和内容监控。

单一 REST 端点

使用 bearer API 密钥和公开帖子 URL 或帖子 ID 调用 GET /v1/instagram/post。Instagram 帖子下载器 API 通过文档化的 HTTP 请求返回帖子详情，应用无需维护浏览器爬虫或非官方客户端 SDK 即可检索帖子信息。

URL 或帖子 ID 输入

直接提交公开帖子 URL，或从 URL 中提取的帖子标识符——管道已有哪种格式就用哪种。两者解析到相同的结构化响应，集成无需额外解析步骤即可接受用户链接。

结构化 JSON 输出

以可预测的 JSON 响应接收 id、url、name、text、username、media_type、created_at 和包含浏览、点赞、评论、分享数的 metrics 对象。此结构适合存储帖子记录、构建集合或供下游分析管道使用。

帖子与作者上下文

每个响应将帖子 URL 与其文案、作者用户名和发布日期配对。下载器工作流、归档系统和研究工具获得完整可引用的公开帖子记录，而非裸链接。

可预测错误码

使用文档化状态码处理失败：400 表示无效请求，401 表示缺少或错误 API 密钥，402 表示余额不足，502、503 或 504 表示临时上游问题。每个响应标识问题类别，重试和告警逻辑保持简单。

五种语言示例

本页直接从 API 的 OpenAPI 定义生成 curl、JavaScript、Python、Java 和 Go 请求示例。采用技术栈已有的语言和 HTTP 客户端，将集成保持为一次标准认证 GET。

使用步骤

按照以下六个步骤调用 Instagram 帖子下载器 API，传递公开帖子 URL 或 ID，并在应用中处理返回的详情。

01

创建 API 密钥

创建 AgentBody 账户并在控制台生成 API 密钥。将密钥保存在服务器环境或批准的密钥存储中，作为 bearer token 发送。切勿将活密钥放入浏览器代码、公共仓库或客户端包中。

02

选择公开帖子

选择需要详情的公开 Instagram 帖子——图片、轮播或视频——复制其 URL 或提取帖子 ID。私密帖子、已删除帖子和快拍无法解析——当工作流需要覆盖时准备替代方案。

03

构建 GET 请求

向 /v1/instagram/post 发送带 url 或 post_id 查询参数的认证 GET 请求。本页生成的示例展示了 curl、JavaScript、Python、Java 和 Go 中针对服务已有 HTTP 客户端的确切请求。

04

密钥保持服务端

从后端、无服务器函数或定时任务调用端点——任何 API 密钥不暴露给浏览器的地方。如需向最终用户开放查询，通过自有端点代理，确保密钥和计费保持可控。

05

解析 JSON 响应

读取返回的 id、url、name、text、username、media_type、created_at 和 metrics 字段。仅存储产品所需字段，保持帖子 URL 与其作者和文案上下文配对，保留策略与自有隐私政策一致。

06

正确处理错误

通过修正请求修复 400 响应，通过配置有效密钥修复 401，通过充值余额解决 402。使用退避重试 502、503 和 504 响应，因为这些表示临时上游状况而非帖子永久问题。

常见问题

什么是 Instagram 帖子下载器 API？

Instagram 帖子下载器 API 是认证 GET 端点 /v1/instagram/post，返回公开 Instagram 帖子的详情——URL、文案、作者用户名、发布日期、媒体类型和互动数据——以结构化 JSON 格式。使用 bearer API 密钥发送公开帖子 URL 或帖子 ID，在应用中处理响应。

有免费的 Instagram 帖子下载器 API 吗？

可以从免费 AgentBody 账户开始，每次调用使用账户额度，API 在承诺用量前可免费试用。基于用量的定价由网关管理而非本页固定数字——查看控制台了解当前每次调用成本。

可以替代 Instagram 帖子下载器爬虫吗？

可以，用于公开帖子详情。无需维护带浏览器自动化、代理和解析代码的 Instagram 帖子下载器爬虫，只需调用一个文档化 REST 端点并接收稳定 JSON 字段。API 仅读取公开数据，无法绕过私密或已删除帖子。

Instagram 帖子 API 响应包含什么？

成功响应包含 id、url、name、text、username、media_type、created_at 和包含浏览、点赞、评论、分享数的 metrics 对象。url 字段携带帖子链接，metrics 捕获请求时的互动数据。直接在存储、搜索或分析工作流中使用这些字段。

API 返回图片文件或下载链接吗？

返回包含帖子 URL 的结构化帖子详情——而非重新编码的媒体文件。应用处理公开帖子记录：链接、作者、文案和数据。媒体处理（如有）属于自有管道，需遵守 Instagram 条款。

如何处理 API 错误？

通过修正请求修复 400，通过配置有效密钥修复 401，通过充值余额解决 402。将 502、503 和 504 视为临时上游故障并使用退避重试。重试前记录状态码和错误码，以便管道区分错误请求和临时问题。