ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Публикация историй Instagram через API

API Instagram публикует историю из одного изображения или видео по публичному URL: сначала создайте контейнер с media_type STORIES, затем опубликуйте его. Изображения в JPEG до 8 МБ, видео длиной от 3 до 60 секунд и до 100 МБ, Meta рекомендует кадр 9:16, а история пропадает через 24 часа, как и в приложении.

easyCoexistence публикует истории с изображением и видео через publish_instagram_post из Claude, ChatGPT или собственного кода и может планировать их в собственной очереди.

60 s

Самое длинное видео для истории, которое публикует API; самое короткое длится 3 секунды, а файл может достигать 100 МБ.

8 MB

Самое большое изображение для истории; оно должно быть в формате JPEG.

24 hours

Сколько времени опубликованная история остаётся видимой до истечения срока.

Under 5

Слишком низкие значения метрик истории возвращаются как код ошибки 10 (недостаточно зрителей), а не числом.

Как публикуется история?

С помощью тех же двух вызовов, что и для любой публикации: POST /<IG_ID>/media с media_type, равным STORIES, и либо image_url, либо video_url, затем POST /<IG_ID>/media_publish с ID контейнера. Видео для истории сначала обрабатывается, поэтому status_code его контейнера должен быть FINISHED, прежде чем его можно опубликовать.

Справочник Meta описывает подпись для фото, видео и каруселей, но не для историй, поэтому текст, адресованный зрителю, нужно размещать внутри самого изображения или видео.

Каковы требования к медиа для историй?

Meta рекомендует кадр 9:16 как для изображений, так и для видео истории, чтобы избежать обрезки или пустого пространства.

  • Изображение: JPEG до 8 МБ в sRGB; другие цветовые пространства преобразуются.
  • Видео: MOV или MP4 с видеокодеком H.264 или HEVC и аудио AAC, 23–60 кадров в секунду, ширина до 1920 пикселей и 25 Мбит/с.
  • Длина видео: от 3 до 60 секунд, размер файла до 100 МБ.
  • Соотношение сторон видео: принимается любое от 0,1:1 до 10:1.

Что может нести история?

Само изображение или видео и упоминания других аккаунтов: с июля 2025 года параметр user_tags отмечает публичные аккаунты в историях с изображением и видео, а координаты x и y необязательны. Meta не поддерживает публикацию стикеров через API, поэтому ссылки, опросы и геометки остаются в приложении.

Что происходит после публикации истории?

Она остаётся видимой 24 часа, а затем истекает, как и в приложении. Meta выводит активные истории в отдельном edge stories; список медиа аккаунта, GET /<IG_ID>/media, их не включает. При чтении media_type истории равен IMAGE или VIDEO, как у любого другого медиа, поэтому истории отличаются по тому, где вы их нашли, а не по типу.

Как приходят ответы и упоминания?

Как личные сообщения. Ответ на историю поступает аккаунту как DM через вебхук messages, с приложенными ID и URL истории, и открывает обычное 24-часовое окно для ответа. Когда кто-то упоминает аккаунт в собственной истории, это тоже приходит сообщением, с вложением типа story_mention. Mentions API от Meta истории не охватывает.

Какие метрики показывает история?

Охват, просмотры, поделились, ответы, подписки, посещения профиля, активность профиля, навигация, переходы по ссылке, репосты и общее число взаимодействий. Они читаются через эндпоинт media insights. Метрики доступны только 24 часа, а значение ниже 5 возвращает код ошибки 10 (недостаточно зрителей) вместо числа. Ответы от людей в Европе и Японии не учитываются, и история, созданная аккаунтом в этих регионах, показывает 0 ответов.

Распространённые ошибки

  • Планирование стикера со ссылкой. API не публикует стикеры, поэтому ссылку нужно передать другим способом, например ответом в DM.
  • Чтение метрик истории на следующий день. Они доступны только 24 часа, поэтому собирайте их, пока история активна.
  • Поиск опубликованной истории в списке медиа аккаунта. Активные истории выводятся в отдельном edge stories.
  • Публикация горизонтального видео как истории. Meta рекомендует 9:16, а другие форматы могут показывать пустое пространство или обрезаться.
Настройка с EasyCoexistence

Ответы на историю приходят как DM, их можно переслать на ваш эндпоинт или получить ответ от автоматизации. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатно.

Часто задаваемые вопросы

Можно ли добавить к истории ссылку-стикер через API?

Нет. Meta не поддерживает публикацию стикеров через API, включая ссылки, опросы и геометки. Упоминание другого аккаунта без стикера поддерживается.

Где в API отображается опубликованная история?

В отдельном edge stories аккаунта, пока история активна. GET /<IG_ID>/media истории не включает, а история возвращается как IMAGE или VIDEO.

Может ли у истории быть подпись через API?

Нет. Справочник Meta не описывает подпись для историй, а publish_instagram_post публикует историю без неё, поэтому текст, адресованный зрителю, размещается внутри самого изображения или видео.

Как долго доступна статистика историй?

24 часа. Meta делает метрики историй доступными только этот срок, поэтому читайте их, пока история активна.

Читайте дальше

Лимиты публикации в Instagram API: форматы, размеры и посты в деньЧто вмещает публикация через Instagram API и сколько их в сутки: JPEG до 8 МБ, Reels, Stories, подписи до 2 200 символов, 100 постов за 24 часа.Публикация Reels в Instagram через APIКак Instagram API публикует Reels: требования Meta к видео, контейнеры и время обработки, показ в Feed, обложки и метрики Reels.Статистика Instagram через API: метрики аккаунта и постовМетрики, которые API Instagram возвращает для аккаунта и каждого поста, Reels и Stories, с порогами Meta, задержками и переименованными метриками.Instagram DM через API и 24-часовое окноКак работают личные сообщения Instagram через API: кому может писать аккаунт, окно 24 часа, приватные ответы и настройка «Allow access to messages».Ошибки Instagram API: что означают распространённые кодыЧастые ошибки Instagram API: истёкшие токены, лимиты частоты, медиа, которые Meta не может загрузить, дневной лимит публикаций, закрытые окна переписки.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на