Ограничения Instagram API: вызовы за 24 часа и пропускная способность личных сообщений
API Instagram выделяет каждому приложению бюджет вызовов на каждый обслуживаемый аккаунт: 4 800 вызовов, умноженных на количество показов аккаунта за скользящие 24 часа. Для обмена сообщениями действуют отдельные ограничения на аккаунт: 100 текстовых сообщений в секунду через Send API, 10 для аудио или видео и 750 частных ответов в час. Сверх бюджета вызовы завершаются ошибкой 80002, а заголовок X-Business-Use-Case-Usage показывает, сколько бюджета израсходовано.
easyCoexistence может пересылать комментарии, упоминания и личные сообщения каждого аккаунта Instagram на ваш эндпоинт по мере поступления, поэтому агент реагирует на события, а не опрашивает их.
Количество вызовов, которое приложение может сделать для одного аккаунта за скользящие 24 часа, без учёта сообщений.
Частные ответы на аккаунт на комментарии к постам и Reels; комментарии к трансляции Live допускают 100 в секунду.
Вызовы Send API на аккаунт для текста, ссылок, реакций и стикеров; для аудио или видео допускается 10.
Публикации через API на аккаунт за скользящий 24-часовой период, проверяются при публикации контейнера.
Код ошибки, который приложение получает при достижении ограничения Business Use Case в Instagram.
Как Instagram считает вызовы API?
По паре «приложение и аккаунт» за скользящие 24 часа. Эндпоинты Instagram подпадают под ограничения Business Use Case от Meta, и число вызовов приложения для одного профессионального аккаунта ограничено 4 800, умноженными на показы этого аккаунта: сколько раз любой его контент появился на экране человека за последние 24 часа. Обмен сообщениями считается отдельно, а Business Discovery и Hashtag Search подчиняются ограничениям платформы Meta.
Влияет ли использование одного аккаунта на другой?
По этой формуле нет. Meta ведёт подсчёт отдельно для каждой пары «приложение и пользователь приложения», поэтому приложение, обслуживающее много профессиональных аккаунтов, имеет отдельный бюджет для каждого из них, рассчитанный по его собственным показам. Аккаунт, чей контент видят чаще, получает больше вызовов, а новый или малоактивный аккаунт получает меньше.
Каковы ограничения на сообщения?
Отдельно от подсчёта за 24 часа, задаются для каждого профессионального аккаунта Instagram и для каждого API:
- Send API: 100 вызовов в секунду для текста, ссылок, реакций и стикеров и 10 в секунду для аудио или видео.
- Частные ответы: 750 вызовов в час на комментарии к постам и Reels и 100 в секунду на комментарии к Live.
- Conversations API: 2 вызова в секунду.
Как здесь учитывается лимит публикаций?
Рядом с бюджетом вызовов, как отдельный счётчик постов. Руководство Meta по публикации допускает 100 публикаций через API на аккаунт за скользящий 24-часовой период, проверяемый при вызове POST /<IG_ID>/media_publish. Вызов сверх лимита завершается с кодом 9 и подкодом 2207042. Что может содержать пост, количество контейнеров и content_publishing_limit относятся к лимитам публикации.
Как Meta сообщает об использовании?
В заголовке ответа. Вызовы в рамках ограничений Business Use Case возвращают X-Business-Use-Case-Usage, JSON-строку с ID в качестве ключа. Для Instagram поле type содержит значение instagram. Поля call_count, total_cputime и total_time выражены в процентах от допустимого объёма, и вызовы могут быть ограничены, когда время CPU или общее время достигает 100. estimated_time_to_regain_access показывает, через сколько минут приложение с ограничением сможет снова вызывать API.
x-business-use-case-usage: {
"<ID>": [
{
"type": "instagram",
"call_count": 28,
"total_cputime": 12,
"total_time": 15,
"estimated_time_to_regain_access": 0
}
]
}Что происходит при достижении лимита?
Вызовы завершаются ошибкой, пока счётчик не опустится ниже лимита. Для ограничения Business Use Case в Instagram код ошибки 80002. Meta предупреждает, что вызовы, сделанные при ограничении, всё равно увеличивают счётчик, и это отодвигает момент, когда вызовы снова начнут проходить. Обмен сообщениями учитывается отдельно от этого бюджета, по собственным ограничениям в секунду и в час.
Как оставаться в рамках ограничений?
Собственные рекомендации Meta, применённые к Instagram:
- Получайте комментарии, упоминания и сообщения через вебхуки, а не опросом: Meta рекомендует их, чтобы сократить число нужных приложению вызовов.
- Распределяйте вызовы равномерно, а не пакетами.
- Запрашивайте только нужные поля и избегайте запросов с пересекающимися данными.
- Считайте вызовы в пакете по одному: Meta засчитывает каждый запрос внутри пакета как отдельный вызов.
- Останавливайтесь при ограничении и возобновляйте работу после
estimated_time_to_regain_access.
Распространённые ошибки
- Повторная отправка ограниченного вызова в цикле. Meta засчитывает вызовы, сделанные при ограничении, что откладывает момент, когда вызовы снова начнут проходить.
- Опрос на новые комментарии или сообщения. Вебхуки доставляют их по мере появления и снижают счётчик вызовов.
- Чтение estimated_time_to_regain_access как секунд. Meta указывает его в минутах, поэтому клиент, который ждёт столько секунд, снова вызывает API, всё ещё находясь под ограничением.
- Наблюдение только за call_count. Поля total_cputime и total_time тоже учитываются при ограничении, поэтому отслеживайте все три процента в заголовке.
Когда Meta ограничивает вызов, Claude, ChatGPT или ваш код получают код ошибки и сообщение Meta. Также каждые 6 часов проверяется состояние каждого подключённого аккаунта. От US$ 9 до US$ 0,75 за подключение в месяц: цена снижается по мере добавления подключений. Первые 3 дня бесплатно.
Часто задаваемые вопросы
Сколько вызовов API может сделать аккаунт Instagram в день?
4 800 на каждый показ, который его контент получил за последние 24 часа, с подсчётом по приложению и аккаунту, поэтому аккаунт, который видят чаще, получает больше вызовов.
Что такое ошибка 80002 Instagram API?
Ограничение Business Use Case в Instagram: приложение израсходовало бюджет вызовов для этого аккаунта. Прекратите вызовы и подождите время, которое указано в заголовке использования.
Учитываются ли личные сообщения в формуле 4 800?
Нет. Обмен сообщениями из неё исключён и имеет собственные ограничения на аккаунт, например 100 текстовых сообщений в секунду через Send API.
Делят ли частные ответы ограничение с личными сообщениями?
Нет. Meta задаёт для них отдельные ограничения: 750 в час на аккаунт для комментариев к постам и Reels и 100 в секунду для комментариев к Live, отдельно от ограничений Send API для личных сообщений.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на