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

Получение постов аккаунта Instagram через API

GET /<IG_ID>/media возвращает посты профессионального аккаунта Instagram в виде объектов IG Media, до 10 000 самых недавно созданных. Запрашивайте поля id, media_type, media_url, permalink, thumbnail_url и timestamp, а элементы карусели читайте через children. В ответах есть курсоры before и after для пагинации, а since и until ограничивают выборку датой. При входе через Instagram Login запрос идёт на graph.instagram.com.

easyCoexistence выводит посты подключённого аккаунта Instagram через list_social_posts, по 1–100 за раз, из Claude, ChatGPT или вашего кода, через официальный API Meta с добавленным токеном.

10,000

Сколько самых недавно созданных медиа возвращает media edge, не больше, по справке Meta IG User Media.

since, until

Параметры пагинации media edge по времени, которые принимают Unix-метки времени или значения strtotime.

/stories

Где читаются Stories: media edge не возвращает медиа Stories.

VIDEO only

Тип медиа, для которого возвращается thumbnail_url: URL миниатюры изображения.

Optional

Как Meta советует относиться к media_url, который для некоторых видео отсутствует: запасным вариантом служат permalink или thumbnail_url.

Как получить посты аккаунта?

Через GET к media edge аккаунта с перечнем нужных полей; без fields пример Meta возвращает только id каждого поста. При входе через Instagram Login запрос идёт на graph.instagram.com с токеном доступа пользователя Instagram, содержащим instagram_business_basic. Ответ перечисляет посты в data, а объект paging содержит ссылку на следующую страницу.

Listing posts with their main fields
GET https://graph.instagram.com/<IG_ID>/media
  ?fields=id,media_type,media_url,permalink,thumbnail_url,timestamp
  &limit=25
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    {
      "id": "<IG_MEDIA_ID>",
      "media_type": "IMAGE",
      "media_url": "<CDN_URL>",
      "permalink": "https://www.instagram.com/p/<SHORTCODE>/",
      "timestamp": "2026-10-30T14:02:11+0000"
    }
  ],
  "paging": {
    "cursors": { "before": "<CURSOR>", "after": "<CURSOR>" },
    "next": "<NEXT_PAGE_URL>"
  }
}

Какие поля может вернуть каждый пост?

Поля объекта IG Media из справки Meta; запрашивайте только те, что используете. Две строки в этой справке, caption и media_product_type, помечены: доступно только для Instagram API с Facebook Login, поэтому проверьте их по своей настройке, прежде чем на них полагаться:

idThe media's ID
media_typeCAROUSEL_ALBUM, IMAGE or VIDEO
media_urlThe image or video file; left out for some videos
thumbnail_urlA thumbnail image, on VIDEO media only
permalinkThe post's permanent URL; not on carousel items
timestampCreation date, ISO 8601 in UTC
shortcodeThe post's shortcode
usernameThe account that created the post
comments_count, like_countCounts; like_count is left out when the owner hides likes
alt_textDescriptive text for an image
is_comment_enabledWhether comments are turned on
caption, media_product_typeMarked Facebook Login only in Meta's reference

Как работает пагинация?

Курсорами. Объект paging содержит курсоры before и after и, пока остаются результаты, URL в поле next. Руководство Meta по Graph API велит остановиться, когда next перестаёт появляться, поскольку страница может содержать меньше элементов, чем запрошено в limit. Media edge также поддерживает пагинацию по времени: since и until принимают Unix-метки времени или значения strtotime и ограничивают результаты этим диапазоном.

Как читать фото и видео карусели?

Через children edge. Пост, у которого media_type равен CAROUSEL_ALBUM, перечисляет свои элементы запросом GET /<IG_MEDIA_ID>/children с тем же токеном и тем же разрешением, что и для media edge. Каждый элемент является объектом IG Media со своими id, media_type и media_url. Meta отмечает, что некоторые поля, среди них permalink, нельзя использовать для фото внутри альбома.

A carousel's items
GET https://graph.instagram.com/<IG_MEDIA_ID>/children
  ?fields=id,media_type,media_url
  &access_token=<ACCESS_TOKEN>

Почему у некоторых постов нет media_url?

Meta не возвращает его для видео с материалами, защищёнными авторским правом, или с лицензированным аудио, включая треки из библиотеки аудио Instagram, а также для медиа, помеченного как нарушение авторских прав; это касается и собственных постов аккаунта. В справке сказано считать media_url необязательным и использовать запасной вариант permalink или thumbnail_url. Live-видео можно читать только во время трансляции.

Как показать посты на сайте?

С вашего сервера, с долгоживущим токеном аккаунта, который действует 60 дней и должен обновляться до истечения срока. Привязывайте каждую плитку к её permalink и обновляйте список по расписанию: Meta отдаёт медиа через CDN-адреса с учётом приватности, которые перестают возвращать файл после удаления контента или истечения срока его действия. Чтобы показать пост так, как его отрисовывает Instagram, вместо этого передайте его permalink в эндпоинт oEmbed.

Как получить список постов через easyCoexistence?

С помощью list_social_posts, который принимает account_id и limit от 1 до 100 (по умолчанию 25) и возвращает последние посты аккаунта с их ID, типами медиа, URL медиа, миниатюрами, permalink, временными метками и количеством лайков и комментариев. Он читает самые последние посты, до 100, и не имеет курсора для следующих страниц или других полей.

Распространённые ошибки

  • Поиск Stories в media edge. Meta их не включает; GET /<IG_ID>/stories возвращает их в течение 24 часа, пока они активны.
  • Построение ленты только на media_url. Meta не возвращает его для некоторых видео, поэтому оставляйте permalink или thumbnail_url как запасной вариант.
  • Запрос permalink для элементов карусели. Meta не возвращает его для фото внутри альбома, поэтому ссылайтесь на родительский пост.
  • Принятие короткой страницы за последнюю. Страница может содержать меньше элементов, чем limit; останавливайтесь только тогда, когда пагинация не содержит next.
Настройка с EasyCoexistence

От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений; первые 3 дня бесплатно.

Часто задаваемые вопросы

Сколько постов может вернуть API Instagram?

До 10 000 самых недавно созданных, постранично из media edge. Stories приходят из отдельного stories edge, пока они активны.

Включает ли media edge Reels?

Да. Reel является объектом IG Media, как и фото, и возвращается с media_type VIDEO. Stories как раз не включаются в media edge.

Можно ли получить посты другого аккаунта?

Не через media edge, который читает аккаунт, стоящий за токеном. Business Discovery возвращает посты другого бизнес-аккаунта или аккаунта креатора при входе через Facebook Login или Unified Login.

Почему перестал работать старый media_url?

CDN-адреса Meta учитывают приватность: они перестают возвращать медиа после удаления контента или истечения срока его действия, поэтому запрашивайте актуальные URL, когда они нужны.

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

Что такое Instagram Graph API? Instagram API в 2026 годуInstagram Graph API в 2026 году: API Meta для Instagram с Instagram Login, Facebook Login или Unified Login, его возможности и подходящие аккаунты.Встраивание публикаций Instagram на сайт через oEmbedЭндпоинт oEmbed от Meta возвращает HTML для встраивания публичной публикации или Reel. С мая 2026 года токен не нужен: параметры, поля и ограничения.API поиска по хэштегам в Instagram: поиск постов по хэштегуКак поиск по хэштегам в Instagram находит публичные посты: ig_hashtag_search, top_media и recent_media, лимит 30 хэштегов за 7 дней и нужный вход.Количество подписчиков и поля профиля Instagram через APIКакие поля профиля отдаёт API Instagram: followers_count, follows_count, media_count, username, фото, биографию и сайт, и что доступно при каждом входе.Отметки людей и место в публикации Instagram через APIКак отметить людей через user_tags и добавить место через location_id в API Instagram: какие публикации поддерживают и как найти location_id.Лимиты публикации в Instagram API: форматы, размеры и посты в деньЧто вмещает публикация через Instagram API и сколько их в сутки: JPEG до 8 МБ, Reels, Stories, подписи до 2 200 символов, 100 постов за 24 часа.

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

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

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

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