Instagram Content Publishing API: публикация фото, Reels и каруселей

Как работает публикация через Instagram API?

Разрешения и токен для публикации

естьнет

Поддерживаемые типы медиа и требования

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

1. 1

   Разместите медиа публично

   Положите файл по публичному HTTPS-адресу без авторизации. Meta скачивает медиа через cURL в момент попытки публикации, поэтому ссылка должна работать именно тогда.

2. 2

   Создайте контейнер

   POST /<IG_ID>/media с image_url (или media_type=REELS и video_url) и необязательной подписью caption. В ответе — ID контейнера.

3. 3

   Дождитесь обработки

   Для видео и каруселей запрашивайте GET /<CONTAINER_ID>?fields=status_code, пока не будет FINISHED. Meta рекомендует проверять не чаще раза в минуту и не дольше 5 минут.

4. 4

   Опубликуйте

   POST /<IG_ID>/media_publish с creation_id=<CONTAINER_ID>. ID в ответе — это ID опубликованного медиа Instagram.

5. 5

   Прочитайте результат

   Запросите поля медиа по новому ID (например, permalink) и сохраните ссылку на пост.

Как выглядят «сырые» запросы

Вызовы на уровне платформы с хостом Instagram Login. Для Facebook Login замените хост на graph.facebook.com, а токен — на токен страницы.

# 1. Контейнер для JPEG-изображения
curl -X POST "https://graph.instagram.com/v23.0/$IG_ID/media" \
  -H "Authorization: Bearer $IG_TOKEN" \
  -d "image_url=https://cdn.example.com/photo.jpg" \
  --data-urlencode "caption=Новая коллекция"
# -> {"id": "<CONTAINER_ID>"}

# 2. Проверка статуса (для видео и каруселей)
curl -G "https://graph.instagram.com/v23.0/$CONTAINER_ID" \
  -H "Authorization: Bearer $IG_TOKEN" -d "fields=status_code"

# 3. Публикация
curl -X POST "https://graph.instagram.com/v23.0/$IG_ID/media_publish" \
  -H "Authorization: Bearer $IG_TOKEN" -d "creation_id=$CONTAINER_ID"

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

import asyncio, os
from socialift import 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(token, image_url=f"{CDN}/photo.jpg", caption="Новая коллекция")
        reel = await ig.publish(token, video_url=f"{CDN}/teaser.mp4", is_reel=True, caption="За кадром")
        album = await ig.publish_carousel(
            token, image_urls=[f"{CDN}/1.jpg", f"{CDN}/2.jpg", f"{CDN}/3.jpg"], caption="Лукбук"
        )
        post = await ig.media_details(photo["media_id"], token)
        print(post.get("permalink"), reel["media_id"], len(album["children"]))

asyncio.run(main())

Сколько постов в сутки можно опубликовать через API?

Коды статуса контейнера

Частые ошибки публикации и как их избежать

• ▸URL требует авторизации, редиректит на страницу входа или истёк (подписанные ссылки) — Meta не может скачать файл.
• ▸Изображение в PNG, WebP или другом формате — сначала конвертируйте в JPEG.
• ▸Соотношение сторон вне диапазона 4:5–1.91:1 — обрежьте перед загрузкой.
• ▸media_publish вызван до того, как контейнер видео или карусели стал FINISHED.
• ▸Отправлен media_type=VIDEO — для одиночного видео используйте REELS.
• ▸В карусели больше 10 элементов или подпись длиннее 2200 символов, 30 хештегов или 20 упоминаний.
• ▸Массовый импорт упёрся в окно 100 постов — сначала проверьте content_publishing_limit.
• ▸Ожидание shopping tags, фильтров или стикеров в историях — API их не поддерживает.