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

2026 年 Instagram API 指南:从应用到第一条帖子

2026 年,Instagram API 通过六个步骤让应用发布第一条帖子:专业账户、登录设置、Meta 应用、权限的访问级别、访问令牌,然后用 POST /<IG_ID>/media 创建媒体容器,再用 media_publish 发布。评论、私信、Webhook、数据洞察和 Meta 的限制在此之后。对于新应用,Meta 建议使用 Unified Login。

easyCoexistence 将第 2 至 5 步合并为一次 Instagram 登录:其 Meta 应用负责登录,在令牌过期前续期,并每 6 小时检查一次账户;Claude、ChatGPT 或您自己的平台则通过 Meta 官方 API 发布、排程、回复评论和私信,并读取数据洞察。

3 setups

Unified Login 推荐用于新集成,Instagram Login 与 Facebook Login 则保留给已有的集成。

New apps

Meta 的迁移指南称,新创建的 Meta 应用无法通过 Instagram Login 设置 Instagram API。

60 days

长期 Instagram 用户访问令牌的有效期;满 24 小时后可以刷新。

100 posts

一个账户在 24 小时滚动周期内可通过 API 发布的帖子数量,轮播帖子算作一条。

2 to 3 days

App Review 通常所需的时间(据 Meta 的说明):Meta 一般在不到一周内处理一份提交。

从新应用到第一条帖子需要哪些步骤?

前六个步骤带你发布第一条帖子,之后的四个步骤决定应用发布后能做什么。账户必须是专业账户,应用需从 Meta 的三种登录设置中选一种,账户所有者授予权限,应用的服务器保存令牌。之后发布只需两次调用。评论、私信、Webhook、数据洞察和限制随后介绍,最后几节列出每个步骤的完整说明页面。

1Professional accountBusiness or Creator, switched in the Instagram app
2Login setupUnified Login for new apps, Instagram Login for existing ones
3Meta app and permissionsStandard Access to test, Advanced Access through App Review
4Access tokenFrom the owner's sign-in, kept on the server
5First postPOST /<IG_ID>/media, then media_publish

第 1 步:哪种 Instagram 账户可以使用 API?

专业账户,即商业账户或创作者账户。Meta 的 Instagram Platform 仅支持专业账户,两种类型在发布、评论、私信和数据洞察方面的操作方式相同。个人账户可在 Instagram 应用中,于“账户类型和工具”下切换;切换为专业账户时,私密账户会变为公开。Instagram Login 和 Unified Login 无需关联 Facebook 主页,而 Facebook Login 则需要。

第 2 步:应用应使用哪种登录设置?

Meta 记录了三种设置,选择决定主机、令牌和权限名称。其概览推荐新集成使用 Unified Login,其 Unified Login 页面称新的 Instagram API 功能仅在该设置中发布,其迁移指南称新创建的应用无法设置 Instagram Login。已有的 Instagram Login 集成仍可正常使用,Meta 尚未公布终止日期。

  • Unified Login:用户可使用 Instagram 或通过 Facebook Login 登录,选择一个 Business Portfolio,应用随即获得一个 Business Integration System User 令牌。
  • Instagram Login:账户所有者使用 Instagram 登录,调用发往 graph.instagram.com,使用 Instagram 用户令牌和 instagram_business_* 权限。
  • Facebook Login:账户必须关联到本人可管理的 Facebook 主页,并使用 instagram_* 权限和 Page 权限。

第 3 步:如何创建 Meta 应用?

在应用控制台中创建,具体路径取决于所选的设置。Meta 的 Unified Login 指南从一个属于 Business Portfolio 的应用开始,并启用“管理 Instagram 上的消息与内容”用例。在使用 Unified Login 的 API 设置中,应用需创建一个配置,其 config_id 用于指定要请求的权限和资源,保存一个 HTTPS 重定向 URL,并复制登录 URL。已有的 Instagram Login 应用则保留使用 Instagram 登录的 API 设置,其 Instagram 应用 ID 和密钥存放于此。

第 4 步:应用需要哪些权限和访问级别?

每项功能对应一个权限,由账户所有者在登录时授予。Unified Login 使用 instagram_* 系列,例如 instagram_content_publish 和 instagram_manage_comments;Instagram Login 则使用 instagram_business_* 名称。Standard Access 是默认级别,涵盖您拥有或管理的账户,以及在应用中拥有角色的人员。为其他企业的账户提供服务需要 Advanced Access,须通过 App Review 逐项获批,并完成 Business Verification。

第 5 步:应用如何获取访问令牌?

令牌来自账户所有者的登录流程,并在服务器端交换,绝不在浏览器或移动应用中处理。使用 Instagram Login 时,重定向会携带一个代码,该代码有效期为一小时且只能使用一次;它会先换成短期令牌,再换成长期令牌,长期令牌有效期为 60 天,满一天后即可刷新。使用 Unified Login 时,代码会换成 Business Integration System User 令牌,其到期时间取决于配置。

第 6 步:如何发布第一条帖子?

只需两次调用。POST /<IG_ID>/media 携带一个公开的 image_url(由 Meta 自行抓取),用于创建容器;POST /<IG_ID>/media_publish 以该容器的 ID 作为 creation_id 发布,并返回媒体 ID。图片必须为 JPEG 格式。对于 Reel 或其他视频,请检查容器的 status_code,直到其显示为 FINISHED,否则提前发布会失败。

A first photo post with Instagram Login
POST https://graph.instagram.com/v26.0/<IG_ID>/media
  ?image_url=https://www.example.com/images/first-post.jpg
  &caption=Hello%20from%20the%20API
  &access_token=<ACCESS_TOKEN>

{ "id": "<IG_CONTAINER_ID>" }

POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
  ?creation_id=<IG_CONTAINER_ID>
  &access_token=<ACCESS_TOKEN>

{ "id": "<IG_MEDIA_ID>" }

第 7 步:评论和私信如何运作?

两者都由他人发起。GET /<IG_MEDIA_ID>/comments 每次请求最多返回 50 条一级评论;POST /<IG_COMMENT_ID>/replies 可公开回复某条评论;私信回复则会在评论后 7 天内向评论者发送一条私信。私信只能发给先行发消息的用户,多数操作的标准时限为 24 小时,且账户所有者须先在 Instagram 应用中开启“允许访问消息”。

第 8 步:Webhook 如何告知应用发生了什么?

Meta 会向 HTTPS 端点发送 JSON,端点需通过回显 hub.challenge 证明自身,且只需一次。每个事件都会在 X-Hub-Signature-256 中附带签名,即用应用密钥对负载计算的 HMAC-SHA256。应用在应用控制台中选择 comments 和 messages 等字段,然后通过 subscribed_apps 边为每个账户订阅。通知仅发送给 Live 应用,评论通知还需要 Advanced Access。

第 9 步:应用如何读取数据洞察?

通过两条边读取:账户数据用 GET /<IG_ID>/insights,帖子、Reel 或 Story 用 GET /<IG_MEDIA_ID>/insights。覆盖人数、观看次数和 accounts_engaged 等账户指标需设置 period=day 与 metric_type=total_value。2025 年 views 取代了 impressions;部分指标要求至少 100 名粉丝,Meta 指出数据可能延迟最多 48 小时。

第 10 步:哪些限制会影响应用?

Meta 的主要限制以账户为单位设定,因此新账户拥有自己的配额,而不是共用一个:

  • 调用:每个应用和账户在滚动 24 小时内的调用次数,为该账户展示次数的 4,800 倍,不含消息功能。
  • 发布:每个账户在 24 小时内可通过 API 发布 100 条帖子和 400 个媒体容器。
  • 消息:文本的 Send API 每秒 100 次调用,帖子和 Reel 的私人回复每小时 750 次。
  • 容器:未发布的容器保留 24 小时后会过期,需要重新创建。

哪个页面详细介绍每个步骤?

本文档中,每个步骤都有独立的参考页面,涵盖本指南未列出的字段、错误和边缘情况。以下路径位于本站地址之下;代码页面并排展示了 Python 与 Node.js 中的发布、评论、数据洞察和 Webhook 调用:

Account type/docs/instagram/business-or-creator-account
Login setups/docs/instagram/unified-login
Meta app and access/docs/instagram/api-access, /docs/instagram/app-review
Permissions/docs/instagram/api-permissions
Tokens/docs/instagram/access-tokens
Code/docs/instagram/api-python-node
Publishing/docs/instagram/publishing-limits
Webhooks/docs/instagram/webhook-events
Insights/docs/instagram/insights-metrics
Limits/docs/instagram/api-rate-limits
When it stops working/docs/instagram/connection-lost

通过 easyCoexistence 的路径是什么?

用一次登录取代第 2 至 5 步以及 Webhook 设置。在控制台中选择“新建连接”,然后选择 Instagram,使用商业或创作者账户登录,并批准其五项 instagram_business_* 权限。easyCoexistence 的 Meta 应用负责登录、更新令牌,并每 6 小时检查一次账户。随后,Claude、ChatGPT 或您自己的智能体可通过 https://easycoexistence.com/api/mcp 进行操作;您自己的代码可从 get_social_credentials 获取账户 ID 和 API 基础地址;帖子最多可从 easyCoexistence 的队列提前 90 天排程。

常见错误

  • 使用 Instagram Login 启动新应用。Meta 的迁移指南称新创建的应用无法设置它,其概览也推荐新集成使用 Unified Login。
  • 用 Instagram 用户令牌调用 Unified Login 集成。Meta 的 Webhook 指南称,这类令牌和 graph.instagram.com 无法用于 Unified Login。
  • 视频容器创建后立即发布。在 status_code 显示 FINISHED 之前,media_publish 会以子代码 2207027 失败。
  • 轮询评论和私信。Meta 建议使用 Webhook,这能减少应用发出的调用次数,并降低被限流的风险。
使用 EasyCoexistence 完成这些操作

每个连接每月起价 US$ 9,连接越多越便宜,最低降至 US$ 0.75,并提供前 3 天免费试用。

常见问题

获取 Instagram API 访问权限需要多长时间?

对于您拥有或管理的账户,无需等待:Standard Access 从一开始就可以使用。为其他企业提供服务则需要 App Review,据 Meta 所说通常不到一周,还需完成 Business Verification。

新的 Meta 应用还能使用 Instagram Login 吗?

根据 Meta 的迁移指南,不能,该指南称新创建的应用无法设置它。已有的 Instagram Login 集成仍可继续使用,Meta 尚未公布终止日期。

API 能否发布我电脑上的文件?

使用 Instagram Login 时不能,因为 Meta 会从公开的 URL 抓取每个图片或视频。Meta 记录了可续传上传,可接受本地视频文件,适用于基于 Facebook Login for Business 构建的设置,其中包括 Unified Login。

easyCoexistence 每个 Instagram 账户收费多少?

每个 Instagram 账户计为一个连接:每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间