Как опубликовать историю Instagram через API

Как опубликовать историю через Instagram API?

Требования к медиа для истории

Эти требования не проверит ни SDK, ни кабинет — файл загружает Meta на своей стороне. При несоответствии контейнер уходит в ERROR.

естьнет

PNG и WebP не принимаются — конвертируйте в JPEG заранее. Если ссылка требует авторизации или уже истекла, Meta не сможет забрать файл.

Сырые запросы: контейнер и публикация

Без SDK поток выглядит ровно так же. В первом ответе приходит id контейнера, он же становится creation_id во втором запросе.

# 1) Контейнер истории
curl -X POST "https://graph.facebook.com/v26.0/$IG_ID/media" \
  -d "image_url=https://cdn.example.com/story.jpg" \
  -d "media_type=STORIES" \
  -d "access_token=$TOKEN"
# -> {"id":"17998...."}

# 2) Для видео — дождитесь готовности контейнера
curl -G "https://graph.facebook.com/v26.0/17998...." \
  -d "fields=status_code" -d "access_token=$TOKEN"
# -> {"status_code":"FINISHED"}

# 3) Публикация
curl -X POST "https://graph.facebook.com/v26.0/$IG_ID/media_publish" \
  -d "creation_id=17998...." -d "access_token=$TOKEN"

Почему у истории нет параметра caption

Разрешения для двух схем входа

У Instagram две схемы авторизации, и наборы scope у них разные. Страница Facebook нужна только в одной из них.

В схеме Facebook Login, если роль на странице выдана через Business Manager, дополнительно потребуется ads_management или ads_read.

Кто может читать список активных историй

Дневной лимит: в самой документации две разные цифры

Публикация истории через Socialift SDK

SDK собирает создание контейнера, ожидание и публикацию в один вызов и возвращает container_id и media_id.

import asyncio, os
from socialift import ContainerNotReadyError, Instagram

CDN = "https://cdn.example.com"

async def main():
    token = os.environ["IG_USER_TOKEN"]
    async with Instagram.from_env() as ig:
        photo = await ig.publish_story(token, image_url=f"{CDN}/story.jpg")
        try:
            clip = await ig.publish_story(token, video_url=f"{CDN}/story.mp4", wait_timeout=120.0)
        except ContainerNotReadyError as exc:
            print("контейнер ещё не готов:", exc.container_id)
            return
        active = await ig.stories(token, limit=25)
        print(photo["media_id"], clip["media_id"], len(active))

asyncio.run(main())

История страницы Facebook: фото и видео

Истории страницы вообще не используют контейнерный поток Instagram — здесь два собственных протокола.

1. 1

   Фото: сначала неопубликованное фото

   Edge photo_stories принимает только photo_id и не принимает ссылку. Поэтому сначала вызывается POST /<PAGE_ID>/photos?published=false&url=<ссылка> — он возвращает только id, и фото не появляется в ленте.

2. 2

   Фото: публикация как истории

   С полученным id вызывается POST /<PAGE_ID>/photo_stories?photo_id=<id>. Неопубликованное фото хранится на серверах Facebook около 24 часов, после чего photo_id перестаёт работать.

3. 3

   Видео: открыть сессию

   POST /<PAGE_ID>/video_stories?upload_phase=start — в ответе приходят video_id и upload_url. Адрес upload_url ведёт на rupload.facebook.com и берётся из ответа, а не собирается вручную.

4. 4

   Видео: загрузка файла

   POST на тот самый upload_url. Токен здесь передаётся не в query, а в заголовке Authorization: OAuth <token>. При ссылке — заголовок file_url и пустое тело; при файле — заголовки offset и file_size, а в теле байты.

5. 5

   Видео: завершение

   POST /<PAGE_ID>/video_stories?upload_phase=finish&video_id=<id>. Перед этим дождитесь uploading_phase.status == "complete" через GET /<VIDEO_ID>?fields=status.

История страницы: пример SDK и обрыв загрузки

SDK выполняет оба потока внутри: два шага для фото, три для видео и докачку при обрыве.

import asyncio, os
from socialift import Facebook

async def main():
    page_id = os.environ["FB_PAGE_ID"]
    page_token = os.environ["FB_PAGE_TOKEN"]
    async with Facebook.from_env() as fb:
        photo = await fb.publish_photo_story(
            page_id, page_token, photo_url="https://cdn.example.com/story.jpg"
        )
        clip = await fb.publish_video_story(
            page_id, page_token, video="/srv/media/story.mp4", upload_attempts=3
        )
        state = await fb.video_story_status(clip["video_id"], page_token)
        print(photo["post_id"], state.get("publishing_phase"))

        for item in await fb.stories(page_id, page_token, limit=25):
            print(item["post_id"], item["status"])

asyncio.run(main())

Частые ошибки и как их избежать

• ▸Фото в PNG или WebP — для истории Instagram принимается только JPEG.
• ▸Подписанная ссылка истекла или требует входа — Meta забирает файл именно в момент вызова.
• ▸media_publish вызван до того, как контейнер видео стал FINISHED.
• ▸В один контейнер переданы и image_url, и video_url.
• ▸Ожидается caption или стикер — API их не добавляет.
• ▸GET /<IG_ID>/stories вызван с токеном Instagram Login — там этого edge нет.
• ▸Дневной лимит зашит числом в коде — читайте его из content_publishing_limit.
• ▸Видео истории страницы ниже 540p — ошибка приходит не на третьем шаге, а в статусе после загрузки.
• ▸Фото страницы пролежало больше суток: неопубликованный photo_id уже истёк.