Встраивание публикаций Instagram на сайт через oEmbed
Эндпоинт Instagram oEmbed от Meta, GET /instagram_oembed?url=<POST_URL>, возвращает HTML для встраивания публичной публикации или Reel на веб-страницу, а также version, provider_name, provider_url, type и width. С 15 мая 2026 года его можно вызывать без токена доступа, а HTML загружает embed.js от Instagram, чтобы отрисовать публикацию.
easyCoexistence возвращает постоянную ссылку каждой подключённой публикации Instagram через list_social_posts, готовую для передачи в oEmbed, и позволяет Claude, ChatGPT или вашему коду публиковать, планировать и отвечать на комментарии и личные сообщения в аккаунте через официальный API Meta.
С этой даты API Instagram oEmbed от Meta можно вызывать без токена доступа во всех версиях.
Количество запросов в час, которое допускает руководство Meta по oEmbed.
Диапазон, который принимает maxwidth; maxheight не поддерживается.
Поля author_name, author_url и миниатюр пропали из ответов Instagram oEmbed во всех версиях API.
Не поддерживаются эндпоинтом oEmbed, как и публикации из закрытых, неактивных или ограниченных по возрасту аккаунтов.
Как работает эндпоинт oEmbed от Instagram?
Вы отправляете URL публичной публикации и получаете HTML, которым её можно показать. Эндпоинт работает на основном хосте Graph API от Meta, том же, что используют вызовы Facebook Login, а не на graph.instagram.com. Ответ представляет собой небольшой JSON-объект, поле html из которого вставляется на страницу без изменений.
GET /instagram_oembed?url=https://www.instagram.com/p/<SHORTCODE>/
{
"version": "1.0",
"provider_name": "Instagram",
"provider_url": "https://www.instagram.com/",
"type": "rich",
"width": 658,
"html": "<EMBED_HTML>"
}Какие URL он принимает?
Три формата, которые руководство Meta перечисляет для параметра url. Он может передаваться обычным или URL-кодированным. Два примера запроса в руководстве показывают по одному из каждого формата:
- Одиночные изображения и карусели: https://www.instagram.com/p/{media-shortcode}/
- Видео и Reel: https://www.instagram.com/reel/{media-shortcode}/
- Профили: https://www.instagram.com/{username}
Нужен ли токен доступа?
Нет, с 15 мая 2026 года, когда журнал изменений Meta сообщает, что API oEmbed для Instagram стал вызываться без токена. До этого приложениям требовалась функция Meta oEmbed Read, прошедшая App Review, и токен при каждом вызове, а доступ по токену по-прежнему работает. Руководство Meta по oEmbed допускает до 1 000 запросов в час, а объявление о доступе без токена говорит, что приложения с токеном могут получить более высокие ограничения частоты запросов.
Какие параметры он принимает?
Кроме url ещё четыре, по руководству Meta и его справочнику:
- maxwidth: от 320 до 658; в остальном встраивание адаптивное, maxheight не поддерживается.
- hidecaption: true скрывает подпись к публикации; по умолчанию стоит false.
- omitscript: true убирает скрипт из HTML, для страниц, которые сами загружают embed.js один раз и вызывают instgrm.Embeds.process().
- fields: ограничивает ответ перечисленными полями.
Что содержит ответ?
Шесть полей по умолчанию: html, разметка для показа; version, всегда 1.0; provider_name и provider_url, которые называют Instagram; type, тип ресурса oEmbed; и width, в пикселях. 3 ноября 2025 года Meta убрала author_name, author_url, thumbnail_url, thumbnail_width и thumbnail_height из ответов для публикаций Instagram во всех версиях API. Для публикаций вашего собственного аккаунта эдж media по-прежнему возвращает username, permalink и thumbnail_url.
Что нельзя встроить?
Руководство Meta перечисляет, что эндпоинт не охватывает, и одно правило использования:
- Публикации закрытых, неактивных и ограниченных по возрасту аккаунтов.
- Аккаунты, которые отключили встраивание.
- Истории и страницы, которые показывают встраивание внутри Shadow DOM.
- Любое использование помимо показа на фронтенде: Meta строго запрещает использовать метаданные или содержимое эндпоинта в других целях.
Как встроить публикации своего аккаунта?
Возьмите постоянную ссылку (permalink) каждой публикации и передайте её как url. Через easyCoexistence инструмент list_social_posts возвращает последние публикации подключённого аккаунта с их permalink, из Claude, ChatGPT или вашего кода. Поскольку вызов oEmbed не требует токена, ваш сайт может делать его напрямую.
Распространённые ошибки
- Отправка ссылки на Историю. Эндпоинт oEmbed от Meta не поддерживает Истории, поэтому встраивайте публикацию или Reel.
- Чтение thumbnail_url из ответа. Meta убрала его вместе с author_name и другими полями миниатюр 3 ноября 2025 года.
- Задание maxwidth меньше 320 или больше 658. Meta принимает значения только из этого диапазона, а maxheight не принимает совсем.
- Загрузка embed.js при каждом встраивании. Если omitscript установлен в true, загрузите скрипт один раз и вызывайте instgrm.Embeds.process().
От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатного пробного периода.
Часто задаваемые вопросы
Можно ли встроить Reel из Instagram?
Да. Передайте его URL вида https://www.instagram.com/reel/{media-shortcode}/, и эндпоинт вернёт HTML для встраивания.
Встраивание в Instagram адаптивное?
Да. Руководство Meta говорит, что встраивание адаптивное, а maxwidth задаёт его максимальную ширину.
Можно ли встроить профиль Instagram?
Да. Руководство Meta перечисляет URL профилей, https://www.instagram.com/{username}, среди форматов, которые принимает параметр url.
Можно ли использовать данные oEmbed для аналитики?
Нет. Meta разрешает эндпоинт только для показа публикации на странице или в приложении и запрещает любое другое использование его метаданных и содержимого.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на