什么是 Instagram Graph API?2026 年 Instagram API 详解
Instagram Graph API 是 Meta 的 Instagram API,即面向 Instagram 专业账户(企业或创作者账户)的一组 API,其参考网址仍保留 Graph API 名称。Meta 现提供三种设置:使用 Instagram Login(调用 graph.instagram.com)、使用 Facebook Login,以及推荐用于新集成的 Unified Login。应用借此发布内容、审核评论、回复私信并读取数据洞察。
easyCoexistence 基于 Instagram API 的 Instagram Login 运行:账户所有者只需使用 Instagram 登录一次,Claude、ChatGPT 或您自己的平台即可通过 Meta 官方 API 发布和排程帖子、回复评论与私信并读取数据洞察,每个连接均全天候 24/7 监控。
Meta 概述中的 Instagram API 设置:Unified Login、Instagram Login 与 Facebook Login。
Instagram API 的 Instagram Login 设置推出时无需关联 Page,调用发往 graph.instagram.com。
Meta 已弃用 Instagram Basic Display API,其更新日志称对该接口的请求会返回错误信息。
Meta 推荐新集成使用的设置,也是唯一会发布新 Instagram API 功能的设置。
Instagram Platform 服务的账户类型:企业或创作者账户。
Meta 现在如何称呼 Instagram Graph API?
Meta 称之为 Instagram Platform,概述将其描述为一组面向 Instagram 专业账户的 API,并按账户所有者的登录方式分为三种设置。Graph API 这一名称保留在参考网址中,即 instagram-graph-api 路径下,也保留在概述的一条说明中:Instagram 公开内容访问功能会开放 Instagram Graph API 的 Hashtag Search 端点。参考文档描述了 IG User、IG Media 等节点及其字段(通过 fields= 请求),以及 /media 和 /stories 等边(edge)。
Meta 记录了哪些设置?
共三种。三者的区别在于账户所有者的登录方式、应用获得的访问令牌以及调用的主机,但都服务于专业账户。Meta 概述推荐新集成使用 Unified Login,并为既有集成保留 Instagram Login 和 Facebook Login:
该 API 涵盖哪些功能?
Meta 概述逐项说明各项功能。Unified Login 在每一行都标注为 Supported;另外两种设置的差异如下表所示。Meta 的 Business Discovery 指南补充说明,查找其他账户可通过 Facebook Login 和 Unified Login 实现:
| Instagram Login | Facebook Login | |
|---|---|---|
| Content publishing | Supported | Supported |
| Comment moderation | Supported | Supported |
| Mentions | Supported | Supported |
| Insights | Supported | Supported |
| Messaging | Supported | Supported, through a separate messaging API |
| Hashtag search | Not supported | Supported |
| Business Discovery | Not listed | Supported |
| Product tagging | Not supported | Supported |
| Partnership ads | Not supported | Supported |
它与 Basic Display API 有什么关系?
Basic Display 已停止服务。Meta 于 2024 年 12 月 4 日弃用该接口,其更新日志称对该接口的请求会返回错误信息,并建议迁移到 Instagram API。该 API 的 Instagram Login 设置于 2024 年 7 月 23 日推出,取消了早期设置所要求的关联 Page。个人账户因此不再有可用的 API,因为 Meta 概述要求使用专业账户,即企业或创作者账户。
它服务于哪些账户?
Instagram 专业账户,Meta 称其可代表企业或创作者。Instagram Login 和 Unified Login 服务于未关联 Page 的账户;Facebook Login 服务于已关联 Page 的账户,且登录者必须能够执行该 Page 上与管理员同等的任务。Standard Access 涵盖您拥有或管理的账户,若要为他人提供服务,则需要通过 App Review 和 Business Verification 获取 Advanced Access。
首次调用是什么样的?
使用 Instagram Login 时,账户所有者登录且应用持有访问令牌后,GET /me 配合 user_id 和 username 会返回该账户的 IG_ID。Meta 的指南称,该 ID 也是其 Webhook 通知中使用的 ID。随后,GET /<IG_ID>/media 按 ID 列出其帖子,并通过 before 和 after 游标获取下一页。
GET https://graph.instagram.com/me
?fields=user_id,username
&access_token=<ACCESS_TOKEN>
GET https://graph.instagram.com/<IG_ID>/media
?access_token=<ACCESS_TOKEN>如何通过 easyCoexistence 使用它?
easyCoexistence 通过 Instagram API 的 Instagram Login 连接账户,并持有 Meta 应用,因此账户所有者只需使用 Instagram 登录并批准权限。随后,Claude、ChatGPT 或您自己的代码即可调用 publish_instagram_post、list_social_posts 和 get_social_insights 等工具,这些工具会附加该账户的访问令牌;get_social_credentials 返回该账户的 ID 和 API 基础地址,绝不返回令牌。
常见错误
- 搭配 Instagram Login 的访问令牌却沿用 Facebook Login 指南。不同设置的主机、访问令牌和权限名称各不相同,因此请让指南与应用所用的设置保持一致。
- 将 API 指向个人账户。Meta 的设置仅服务于专业账户,因此请先在 Instagram 应用中将其切换为企业或创作者账户。
- 照搬 Basic Display 示例。该接口自 2024 年 12 月 4 日起已返回错误;请改用 GET /me 读取账户,并用 /<IG_ID>/media 读取其帖子。
- 计划在 Instagram Login 上进行话题标签搜索。Meta 概述标明该设置不支持此功能,需要 Facebook Login 或 Unified Login。
每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,并提供 3 天免费试用。
常见问题
Instagram Graph API 与 Instagram API 是同一回事吗?
是的。Meta 的文档现在称之为 Instagram API,并按各自使用的登录方式命名设置,同时在参考网址中保留 instagram-graph-api 路径。
Instagram API 需要关联 Page 吗?
使用 Instagram Login 或 Unified Login 时不需要。Facebook Login 是要求专业账户关联 Page 的设置。
新的 Instagram 集成应使用哪种设置?
按 Meta 的推荐,应使用 Unified Login,并且 Meta 只在该设置中发布新的 Instagram API 功能。Meta 的迁移指南规定,新建应用无法设置 Instagram Login,而现有的 Instagram Login 集成仍可继续使用,且尚未公布停止日期。
easyCoexistence 对一个 Instagram 账户收费多少?
每个 Instagram 账户计为一个连接,按您拥有的连接数量每月收取 US$ 9 起、最低降至 US$ 0.75,并提供 3 天免费试用。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间