Instagram Basic Display API 关停:结束了什么,以及如何迁移
Meta 于 2024 年 12 月 4 日关停了 Instagram Basic Display API,此后对它的请求一直失败。对于商业和创作者账户,其替代方案是 Instagram API,其 Instagram Login 版本于 2024 年 7 月推出,无需关联 Facebook 主页。个人账户在 Meta 没有 API,因为 Meta 没有为消费者应用保留任何 API。
easyCoexistence 已通过 Instagram Login 使用 Instagram API:选择新建连接,用 Instagram 登录并选中商业或创作者账户,Claude、ChatGPT 或您自己的代码即可发布内容、回复评论和私信、读取洞察数据,并且连接会全天候受到监控。
Instagram Basic Display API 结束的日期:Meta 表示,从当天起对它的每个请求都将失败。
Meta 于 2024 年 9 月 4 日发出的通知,即宣布关停的那一天。
Meta 推出带 Instagram Login 的 Instagram API 的时间,无需关联 Facebook 主页,调用地址为 graph.instagram.com。
2024 年 12 月 4 日之后,Meta 为消费者开发者应用保留的 Instagram API。
Meta 的 Instagram Platform API 要求的账户类型:商业账户或创作者账户。
什么是 Instagram Basic Display API?
Meta 的一项 API,用于将 Instagram 账户连接到第三方消费者应用,这些应用借助它分享账户的个人资料和图片,Meta 的关停通知也是这样描述的。Meta 于 2024 年 9 月 4 日宣布将其关停,提前 90 天通知,并表示未在积极使用该 API 的开发者无需采取任何行动。
关停了什么,何时关停?
整个 API,在同一天关停。Meta 的时间线:
- 2024 年 9 月 4 日:Meta 宣布该 API 将从 12 月 4 日起不再可用,并给予合作伙伴 90 天时间进行调整。
- 直到 2024 年 12 月 4 日:已获得 Advanced Access 的应用仍可保留该权限,但仍需接受标准权限的重新审核。
- 2024 年 12 月 4 日:API 关停,此后对它的每个请求都会返回错误。
什么取代了它?
对于商业和创作者用途,Meta 建议开发者使用 Instagram API,可通过 Instagram Login 或 Facebook Login 登录。Instagram Login 版本已于 2024 年 7 月 23 日推出:用户通过 Instagram 登录,无需关联 Facebook 主页,调用发往 graph.instagram.com,并使用 instagram_business_* 权限。Meta 表示,预计该版本可满足大多数商业用例。截至 2026 年 10 月 31 日,其概述页面还列出了第三种设置方式 Unified Login,并建议新集成采用它。
个人账户会失去什么?
API 访问权限。Meta 表示,2024 年 12 月 4 日之后,将不再为消费者开发者应用提供一组 Instagram API,而且 Instagram Platform 的每种设置都要求专业账户(商业或创作者账户),因此应用无法再通过 Meta 读取个人账户的个人资料或媒体。剩下的选择是:在 Instagram 应用中将账户切换为专业账户,或使用 Meta 的 oEmbed 嵌入公开帖子和个人资料。自 2026 年 5 月 15 日起,oEmbed 无需访问令牌即可使用,但不涵盖私密账户和 Stories(快拍)。
如何将应用迁移到 Instagram Login?
共六个步骤,从账户本身开始:
- 在 Instagram 应用中,将账户切换为专业账户、商业账户或创作者账户。
- 在 App Dashboard 中添加 Instagram API 设置并选择 Instagram login,它会提供 Instagram 应用 ID 和应用密钥。
- 将用户引导至 https://www.instagram.com/oauth/authorize,并传入 Instagram 应用 ID 作为
client_id、一个redirect_uri、response_type=code,以及一个 scope,其中列出instagram_business_basic和应用使用的其他每项权限。 - 交换授权码(有效期 1 小时,且只能使用一次)以获得短期访问令牌,再换取有效期为 60 天的长期访问令牌,并在过期前刷新。
- 通过 GET /me 从 graph.instagram.com 读取账户,并通过 GET /<
IG_ID>/media 读取其帖子。 - 在为非自己拥有或管理的账户提供服务之前,通过 App Review 申请 Advanced Access,并完成 Business Verification。
常见错误
- 将新登录指向个人账户。每种 Instagram Platform 设置都需要专业账户,因此请先将其切换为商业或创作者账户。
- 在 Instagram 授权 URL 中填入 Meta 应用 ID。Business Login for Instagram 需要从 App Dashboard 的 Instagram 设置中获取 Instagram 应用 ID。
- 照搬 2024 年示例中的 scope 名称。business_basic 及其同类名称已于 2025 年 1 月 27 日弃用,请改用 instagram_business_* 名称。
- 将应用对 Standard Access 下的他人账户开放。它只服务于在该应用中拥有角色的人员,其他人需要通过 App Review 获得 Advanced Access。
每个连接每月 US$ 9 起,连接越多价格越低,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
Instagram Basic Display API 还能正常使用吗?
不能。Meta 已于 2024 年 12 月 4 日将其关停,对它的请求会返回错误。
Instagram 帖子仍可以嵌入网站吗?
可以,公开帖子和个人资料仍可通过 Meta 的 oEmbed 嵌入,自 2026 年 5 月 15 日起无需访问令牌。私密账户和 Stories(快拍)不在此范围内。
哪些 scope 名称可以替代 business_basic?
instagram_business_* 名称,例如 instagram_business_basic。business_basic 及其同类名称已于 2025 年 1 月 27 日弃用,因此从 2024 年示例中复制的 scope 需要更新。
迁移后还需要 App Review 吗?
只有在为您并不拥有或管理的账户提供服务时才需要。这需要 Advanced Access,而它又需要 App Review 和 Business Verification。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间