Получение постов аккаунта 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 с добавленным токеном.
Сколько самых недавно созданных медиа возвращает media edge, не больше, по справке Meta IG User Media.
Параметры пагинации media edge по времени, которые принимают Unix-метки времени или значения strtotime.
Где читаются Stories: media edge не возвращает медиа Stories.
Тип медиа, для которого возвращается thumbnail_url: URL миниатюры изображения.
Как Meta советует относиться к media_url, который для некоторых видео отсутствует: запасным вариантом служат permalink или thumbnail_url.
Как получить посты аккаунта?
Через GET к media edge аккаунта с перечнем нужных полей; без fields пример Meta возвращает только id каждого поста. При входе через Instagram Login запрос идёт на graph.instagram.com с токеном доступа пользователя Instagram, содержащим instagram_business_basic. Ответ перечисляет посты в data, а объект paging содержит ссылку на следующую страницу.
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, поэтому проверьте их по своей настройке, прежде чем на них полагаться:
Как работает пагинация?
Курсорами. Объект 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, нельзя использовать для фото внутри альбома.
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.
От 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, когда они нужны.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на