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

Instagram API 速率限制:每 24 小时调用次数与私信吞吐量

Instagram 的 API 为每个应用在其服务的每个账户分配一份调用额度:在滚动的 24 小时内,额度为该账户曝光次数乘以 4,800 次。消息收发有各自独立的账户级速率:通过 Send API 每秒可发送 100 条文本消息,音频或视频为每秒 10 条,每小时可发送 750 条私密回复。超出额度后,调用会以错误代码 80002 失败,而 X-Business-Use-Case-Usage 响应头会显示已用额度。

easyCoexistence 可以在每个 Instagram 账户的评论、提及和私信到达时,将其转发至您的端点,使智能代理基于事件作出反应,而无需轮询。

4,800

一个应用在滚动的 24 小时内,针对单个账户可按每次曝光进行的调用次数,不含消息收发。

750/hour

每个账户针对帖子和 Reels 评论的私密回复数;直播评论允许每秒 100 条。

100/sec

每个账户通过 Send API 发送文本、链接、表情回应和贴纸的调用次数;音频或视频为 10。

100 posts

在 24 小时滚动周期内,每个账户通过 API 发布的帖子数,在发布容器时执行检查。

80002

应用达到 Instagram 业务用例速率限制时收到的错误代码。

Instagram 如何统计 API 调用?

按应用与账户的组合,在滚动的 24 小时内统计。Instagram 的端点适用 Meta 的业务用例速率限制。对于单个专业账户,应用的调用次数上限为该账户曝光次数的 4,800 倍,曝光次数指过去 24 小时内其任何内容进入用户屏幕的次数。消息收发单独计算,而 Business Discovery 和 Hashtag Search 则改为遵循 Meta 平台的速率限制。

一个账户的用量会影响另一个账户吗?

在该计算方式下不会。Meta 按每个应用与应用用户的组合分别计数,因此为众多专业账户提供服务的应用,每个账户都有独立的额度,额度大小取决于该账户自身的曝光次数。内容被看到次数越多的账户可获得越多调用次数,而新账户或冷门账户可获得的调用次数则较少。

消息收发有哪些限制?

与 24 小时计数分开,按每个 Instagram 专业账户及每个 API 单独设定:

  • Send API:文本、链接、表情回应和贴纸每秒 100 次调用,音频或视频每秒 10 次。
  • 私密回复:针对帖子和 Reels 评论每小时 750 次调用,针对直播评论每秒 100 次。
  • Conversations API:每秒 2 次调用。

发布上限属于哪一部分?

与调用额度并列,是一项单独的帖子计数。Meta 的发布指南规定,在 24 小时滚动周期内,每个账户通过 API 发布的帖子上限为 100 条,在调用 POST /<IG_ID>/media_publish 时进行检查。超出上限的调用会以代码 9、子代码 2207042 失败。帖子可容纳的内容、容器数量以及 content_publishing_limit 则属于发布限制的范围。

Meta 如何报告用量?

通过响应头报告。在业务用例限制下的调用会返回 X-Business-Use-Case-Usage,这是一个以 ID 为键的 JSON 字符串。对于 Instagram,其 type 为 instagram;call_count、total_cputime 和 total_time 表示已用额度的百分比。一旦 CPU 时间或总时间达到 100,调用就可能受到限流。estimated_time_to_regain_access 给出受限应用可再次调用前需等待的分钟数。

The usage header on an Instagram call
x-business-use-case-usage: {
  "<ID>": [
    {
      "type": "instagram",
      "call_count": 28,
      "total_cputime": 12,
      "total_time": 15,
      "estimated_time_to_regain_access": 0
    }
  ]
}

达到上限会怎样?

调用会失败,直到计数回落到上限以下。对于 Instagram 的业务用例限制,错误代码为 80002。Meta 提醒,在受限期间发出的调用仍会计入计数,从而推迟调用恢复成功的时间。消息收发的计数独立于此额度,遵循其各自的每秒和每小时速率。

如何保持在限制之内?

Meta 对 Instagram 的建议如下:

  • 通过 Webhook 接收评论、提及和消息,而不是轮询;Meta 推荐这种方式以减少应用所需的调用次数。
  • 均匀分布调用,而非成批突发发送。
  • 只请求所需的字段,并避免请求重叠的数据。
  • 批处理中的调用需逐一计算:Meta 会将其中的每个请求都计为一次独立调用。
  • 受限时停止调用,并在 estimated_time_to_regain_access 所示时间之后再恢复。

常见错误

  • 在循环中重试受限的调用。Meta 会计入受限期间发出的调用,从而推迟调用恢复成功的时间。
  • 轮询新评论或私信。Webhook 会在事件发生时即时推送,并减少调用次数。
  • 把 estimated_time_to_regain_access 理解为秒。Meta 以分钟为单位给出该值,因此如果客户端等待相应的秒数后再次调用,仍会处于受限状态。
  • 只关注 call_count。total_cputime 和 total_time 同样计入限流,因此要同时跟踪响应头中的三个百分比。
使用 EasyCoexistence 完成这些操作

当 Meta 对某次调用进行限流时,Claude、ChatGPT 或您自己的代码会收到 Meta 的错误代码和消息。它还会每 6 小时检查一次每个已连接的账户。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,并提供前 3 天免费试用。

常见问题

Instagram API 每天每个账户可以调用多少次?

按该账户在过去 24 小时内的每次曝光计算,每次曝光可调用 4,800 次,按应用与账户的组合统计,因此曝光次数越多的账户可获得越多调用次数。

Instagram API 错误 80002 是什么?

这是 Instagram 的业务用例速率限制:该应用已用完该账户的调用额度。请停止调用,并等待用量响应头给出的时间。

私信会计入 4,800 次的计算吗?

不会。消息收发被排除在该计算之外,并有各自的账户级速率,例如通过 Send API 每秒可发送 100 条文本消息。

私密回复与私信速率共用吗?

不共用。Meta 为其设定了独立的速率:针对帖子和 Reels 评论每个账户每小时 750 次,针对直播评论每秒 100 次,这与 Send API 对私信的速率分开。

继续阅读

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

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

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

验证时间