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

Встраивание публикаций 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.

15 May 2026

С этой даты API Instagram oEmbed от Meta можно вызывать без токена доступа во всех версиях.

1,000/hour

Количество запросов в час, которое допускает руководство Meta по oEmbed.

320 to 658

Диапазон, который принимает maxwidth; maxheight не поддерживается.

3 Nov 2025

Поля author_name, author_url и миниатюр пропали из ответов Instagram oEmbed во всех версиях API.

Stories

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

Как работает эндпоинт oEmbed от Instagram?

Вы отправляете URL публичной публикации и получаете HTML, которым её можно показать. Эндпоинт работает на основном хосте Graph API от Meta, том же, что используют вызовы Facebook Login, а не на graph.instagram.com. Ответ представляет собой небольшой JSON-объект, поле html из которого вставляется на страницу без изменений.

A request and its response
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().
Настройка с EasyCoexistence

От 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 разрешает эндпоинт только для показа публикации на странице или в приложении и запрещает любое другое использование его метаданных и содержимого.

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

Получение постов аккаунта Instagram через APIКак API Instagram выводит посты аккаунта через GET /<IG_ID>/media: поля, элементы каруселей, курсоры, пагинация по дате и лента для сайта.Что такое Instagram Graph API? Instagram API в 2026 годуInstagram Graph API в 2026 году: API Meta для Instagram с Instagram Login, Facebook Login или Unified Login, его возможности и подходящие аккаунты.Отключение Instagram Basic Display API: что закрылось и как перейтиС 4 декабря 2024 года Instagram Basic Display API не работает. Что это было, чем его заменили для профессиональных аккаунтов и как перенести приложение.Какие аккаунты Instagram работают с API: бизнес, креатор или личныйAPI Instagram работает с профессиональными аккаунтами: бизнес и креатор. Какой выбрать, что меняется при переходе и как переключиться в приложении.Что умеет Instagram API в 2026 году и что остаётся в приложенииПубликации, комментарии, личные сообщения, статистика и упоминания через Instagram Login в 2026 году, и что остаётся в приложении Instagram.

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

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

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

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