Instagram API 速率限制:每 24 小时调用次数与私信吞吐量
Instagram 的 API 为每个应用在其服务的每个账户分配一份调用额度:在滚动的 24 小时内,额度为该账户曝光次数乘以 4,800 次。消息收发有各自独立的账户级速率:通过 Send API 每秒可发送 100 条文本消息,音频或视频为每秒 10 条,每小时可发送 750 条私密回复。超出额度后,调用会以错误代码 80002 失败,而 X-Business-Use-Case-Usage 响应头会显示已用额度。
easyCoexistence 可以在每个 Instagram 账户的评论、提及和私信到达时,将其转发至您的端点,使智能代理基于事件作出反应,而无需轮询。
一个应用在滚动的 24 小时内,针对单个账户可按每次曝光进行的调用次数,不含消息收发。
每个账户针对帖子和 Reels 评论的私密回复数;直播评论允许每秒 100 条。
每个账户通过 Send API 发送文本、链接、表情回应和贴纸的调用次数;音频或视频为 10。
在 24 小时滚动周期内,每个账户通过 API 发布的帖子数,在发布容器时执行检查。
应用达到 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 给出受限应用可再次调用前需等待的分钟数。
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 同样计入限流,因此要同时跟踪响应头中的三个百分比。
当 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 监控
验证时间