登录开始免费试用
easyCoexistence 官方 API

什么是 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 监控。

3 setups

Meta 概述中的 Instagram API 设置:Unified Login、Instagram Login 与 Facebook Login。

23 Jul 2024

Instagram API 的 Instagram Login 设置推出时无需关联 Page,调用发往 graph.instagram.com。

4 Dec 2024

Meta 已弃用 Instagram Basic Display API,其更新日志称对该接口的请求会返回错误信息。

Unified Login

Meta 推荐新集成使用的设置,也是唯一会发布新 Instagram API 功能的设置。

Professional

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:

Instagram API with Instagram LoginBusiness Login for Instagram, an Instagram User access token, graph.instagram.com and the instagram_business_* permissions; no Page needed
Instagram API with Facebook LoginFacebook Login for Business, a user or Page access token, the instagram_* and Page permissions; the account must be linked to a Page
Instagram API with Unified LoginFacebook Login for Business, which also accepts Instagram credentials, a Business Integration System User access token and a business portfolio; no Page needed

该 API 涵盖哪些功能?

Meta 概述逐项说明各项功能。Unified Login 在每一行都标注为 Supported;另外两种设置的差异如下表所示。Meta 的 Business Discovery 指南补充说明,查找其他账户可通过 Facebook Login 和 Unified Login 实现:

Instagram LoginFacebook Login
Content publishingSupportedSupported
Comment moderationSupportedSupported
MentionsSupportedSupported
InsightsSupportedSupported
MessagingSupportedSupported, through a separate messaging API
Hashtag searchNot supportedSupported
Business DiscoveryNot listedSupported
Product taggingNot supportedSupported
Partnership adsNot supportedSupported

它与 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 游标获取下一页。

Two first calls with Instagram Login
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。
使用 EasyCoexistence 完成这些操作

每个连接每月 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 监控

验证时间