Instagram API в 2026 году: от приложения до первой публикации
В 2026 году Instagram API ведёт приложение к первой публикации за шесть шагов: профессиональный аккаунт, настройка входа, приложение Meta, разрешения нужного уровня доступа, токен доступа, затем медиа-контейнер, созданный через POST /<IG_ID>/media и опубликованный через media_publish. Комментарии, сообщения, вебхуки, инсайты и лимиты Meta идут после. Для новых приложений Meta рекомендует Unified Login.
easyCoexistence превращает шаги со 2 по 5 в один вход через Instagram: его приложение Meta выполняет вход, обновляет токен до истечения срока и проверяет аккаунт каждые 6 часов, а Claude, ChatGPT или ваша собственная платформа публикует, планирует, отвечает на комментарии и сообщения и читает инсайты через официальный API Meta.
Unified Login, который Meta рекомендует для новых интеграций, а также Instagram Login и Facebook Login, сохранённые для существующих.
Новые приложения Meta не могут настроить Instagram API через Instagram Login, говорится в руководстве Meta по миграции.
Срок действия долгоживущего токена доступа Instagram User; обновить его можно, когда ему исполнится 24 часа.
Публикации через API, которые один аккаунт может сделать за скользящий период 24 часа; карусель считается как одна публикация.
Сколько обычно занимает App Review по данным Meta: как правило, заявка рассматривается менее недели.
Какие шаги ведут от нового приложения к первой публикации?
К первой публикации ведут шесть шагов, а ещё четыре определяют, что приложение делает дальше. Аккаунт должен быть профессиональным, приложение выбирает один из трёх вариантов входа Meta, владелец аккаунта выдаёт разрешения, а сервер приложения хранит токен. Публикация затем делается двумя вызовами. Комментарии, сообщения, вебхуки, инсайты и лимиты идут следом, а последние разделы называют страницу, где каждый шаг описан полностью.
Шаг 1: с каким аккаунтом Instagram работает API?
С профессиональным аккаунтом: бизнес или креатор. Платформа Instagram от Meta обслуживает только профессиональные аккаунты, и оба типа работают одинаково для публикаций, комментариев, личных сообщений и инсайтов. Личный аккаунт переключается в приложении Instagram, в разделе «Тип аккаунта и инструменты», а закрытый становится открытым при переключении. Instagram Login и Unified Login не требуют привязанной страницы, тогда как Facebook Login её требует.
Шаг 2: какую настройку входа должно использовать приложение?
Meta описывает три варианта, и выбор определяет хост, токен и имена разрешений. Обзор Meta рекомендует Unified Login для новых интеграций, его страница Unified Login сообщает, что новые функции Instagram API выпускаются только там, а руководство по миграции говорит, что новые приложения не могут настроить Instagram Login. Существующие интеграции Instagram Login продолжают работать, дата их завершения не объявлена.
- Unified Login: клиент входит через Instagram или через Facebook Login, выбирает Business Portfolio, а приложение получает токен Business Integration System User.
- Instagram Login: владелец входит через Instagram, а вызовы идут на graph.instagram.com с токеном Instagram User и разрешениями instagram_business_*.
- Facebook Login: аккаунт должен быть связан со страницей, которой человек может управлять, с разрешениями instagram_* и разрешениями страницы.
Шаг 3: как создаётся приложение Meta?
В панели управления приложениями Meta, по пути, который зависит от настройки. Руководство Meta по Unified Login начинает с приложения со сценарием использования «Manage messaging & content on Instagram», принадлежащего Business Portfolio. В разделе API setup with Unified login приложение создаёт конфигурацию, у которой config_id задаёт запрашиваемые разрешения и ресурсы, сохраняет HTTPS-адрес перенаправления и копирует ссылку входа. Существующее приложение Instagram Login сохраняет API setup with Instagram login, где находятся его ID приложения Instagram и секрет.
Шаг 4: какие разрешения и уровень доступа нужны приложению?
Одно разрешение на каждую функцию, которое владелец аккаунта выдаёт при входе. Unified Login использует семейство instagram_*, например instagram_content_publish и instagram_manage_comments, а Instagram Login имена instagram_business_*. Standard Access, уровень по умолчанию, охватывает аккаунты, которыми вы владеете или управляете, и людей с ролью в приложении. Работа с аккаунтами других компаний требует Advanced Access, которое выдаётся разрешение за разрешением через App Review вместе с Business Verification.
Шаг 5: как приложение получает токен доступа?
Из входа владельца, обмениваемого на сервере и никогда в браузере или мобильном приложении. При Instagram Login перенаправление несёт код, действительный один час и работающий однократно; он становится краткосрочным токеном, затем долгосрочным, который живёт 60 дней и может быть обновлён, когда ему исполнится сутки. При Unified Login код становится токеном Business Integration System User, срок действия которого зависит от конфигурации.
Шаг 6: как опубликовать первую публикацию?
Двумя вызовами. POST /<IG_ID>/media с публичным image_url, который Meta загружает сама, создаёт контейнер; POST /<IG_ID>/media_publish с ID этого контейнера как creation_id публикует его и возвращает ID медиа. Изображения должны быть в формате JPEG. Для Reel или другого видео проверяйте status_code контейнера, пока он не покажет FINISHED, потому что раньше публикация завершится ошибкой.
POST https://graph.instagram.com/v26.0/<IG_ID>/media
?image_url=https://www.example.com/images/first-post.jpg
&caption=Hello%20from%20the%20API
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_CONTAINER_ID>" }
POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
?creation_id=<IG_CONTAINER_ID>
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_MEDIA_ID>" }Шаг 7: как работают комментарии и личные сообщения?
Оба начинаются с другого человека. GET /<IG_MEDIA_ID>/comments возвращает до 50 комментариев верхнего уровня за запрос, POST /<IG_COMMENT_ID>/replies отвечает на один из них публично, а личный ответ отправляет комментатору одно личное сообщение в течение 7 дней после комментария. Сообщения уходят тем, кто написал первым, в пределах стандартного окна 24 часа для большинства действий, когда владелец включает «Разрешить доступ к сообщениям» в приложении Instagram.
Шаг 8: как вебхуки сообщают приложению о событиях?
Meta отправляет JSON на HTTPS-эндпоинт, который подтверждает себя один раз, возвращая hub.challenge, и подписывает каждое событие в заголовке X-Hub-Signature-256 через HMAC-SHA256 от тела, с ключом секрета приложения. Приложение выбирает поля, такие как comments и messages, в панели управления приложениями Meta, затем подписывает каждый аккаунт через ребро subscribed_apps. Уведомления доходят только до приложений в статусе Live, а уведомления о комментариях требуют Advanced Access.
Шаг 9: как приложение читает инсайты?
Из двух рёбер: GET /<IG_ID>/insights для аккаунта и GET /<IG_MEDIA_ID>/insights для публикации, Reel или Story. Метрики аккаунта, такие как reach, views и accounts_engaged, принимают period=day с metric_type=total_value. Метрика views заменила impressions в 2025 году, некоторым метрикам нужно не менее 100 подписчиков, а Meta отмечает, что данные могут отставать до 48 часов.
Шаг 10: какие лимиты определяют работу приложения?
Meta задаёт основные лимиты для каждого аккаунта, поэтому новый аккаунт получает собственную квоту, а не делит общую:
- Вызовы: 4 800 раз от показов аккаунта за скользящие 24 часа, для каждого приложения и аккаунта, без учёта сообщений.
- Публикации: 100 публикаций через API и 400 медиа-контейнеров на аккаунт за 24 часа.
- Сообщения: 100 вызовов Send API в секунду для текста и 750 личных ответов в час на публикациях и Reels.
- Контейнеры: созданный и неопубликованный контейнер истекает через 24 часа, и его нужно создать заново.
Какая страница описывает каждый шаг подробно?
У каждого шага в этой документации есть собственная справочная страница с полями, ошибками и крайними случаями, которые это руководство опускает. Пути ниже находятся под адресом сайта, а страница с кодом показывает вызовы публикации, комментариев, инсайтов и вебхуков на Python и Node.js рядом:
Какой путь через easyCoexistence?
Один вход вместо шагов со 2 по 5 и настройки вебхуков. В панели управления выберите «Новое подключение», затем Instagram, войдите с бизнес- или креаторским аккаунтом и подтвердите его пять разрешений instagram_business_*. Приложение Meta easyCoexistence выполняет вход, обновляет токен и проверяет аккаунт каждые 6 часов. Claude, ChatGPT или ваш собственный агент затем работает через https://easycoexistence.com/api/mcp, ваш код может взять ID аккаунта и базовый адрес API из get_social_credentials, а публикации можно запланировать на срок до 90 дней вперёд из очереди easyCoexistence.
Распространённые ошибки
- Запуск нового приложения на Instagram Login. Руководство Meta по миграции говорит, что новые приложения не могут его настроить, а обзор Meta рекомендует Unified Login для новых интеграций.
- Вызов интеграции Unified Login токеном Instagram User. Руководство Meta по вебхукам говорит, что такие токены и graph.instagram.com не работают с Unified Login.
- Немедленная публикация видеоконтейнера. media_publish завершается ошибкой с подкодом 2207027, пока status_code контейнера не покажет FINISHED.
- Опрос комментариев и сообщений. Meta рекомендует вебхуки, которые сокращают число вызовов приложения и риск ограничения частоты запросов.
Цена от US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений она снижается, первые 3 дня бесплатно.
Часто задаваемые вопросы
Сколько времени занимает получение доступа к Instagram API?
Для аккаунтов, которыми вы владеете или управляете, ждать не нужно: Standard Access работает сразу. Работа с чужими компаниями требует App Review, который, по словам Meta, обычно занимает менее недели, а также Business Verification.
Может ли новое приложение Meta по-прежнему использовать Instagram Login?
Нет, согласно руководству Meta по миграции, новые приложения не могут его настроить. Существующие интеграции Instagram Login продолжают работать, а Meta не объявила даты завершения.
Может ли API опубликовать файл с моего компьютера?
Не через Instagram Login: там Meta загружает каждое изображение или видео по публичному URL. Meta описывает возобновляемые загрузки, которые принимают локальный видеофайл, для настроек на базе Facebook Login для бизнеса, включая Unified Login.
Сколько стоит easyCoexistence для аккаунта Instagram?
Каждый аккаунт Instagram это одно подключение: от US$ 9 до US$ 0,75 за подключение в месяц, со снижением по мере добавления подключений, первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на