instagram/
posts

Собирайте публичные публикации Instagram по одному или нескольким именам пользователей: нормализованные подписи, данные автора, медиафайлы, хештеги, упоминания, метки времени и видимая вовлеченность.

Instagram Posts API

Публикации
Метаданные медиа
Публичные данные
0,34 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Instagram Posts

Публикации Instagram — это записи в ленте с подписями, контекстом автора, изображениями или видео, метками времени, хештегами, упоминаниями и видимой вовлеченностью. Эти сигналы контента помогают исследовать авторов, анализировать кампании и медиа и готовить исторические отчеты.

Возможности Instagram Posts API

  • Сбор публикаций по имени пользователяСобирайте публичные публикации Instagram по одному или нескольким именам пользователей в единой нормализованной структуре ответа.
  • Ссылки на медиа и размерыВозвращает публичные ссылки на медиафайлы и миниатюры, размеры и длительность видео в нормализованных полях медиа.
  • Записи фото и видеоПриводит публичные фото- и видеопубликации к одной структуре ответа.
  • Поля контента и вовлеченностиДобавляет к каждой записи публикации текст подписи, данные автора, время публикации, видимые метрики, хештеги и упоминания.
  • Только публичные данныеЗакрытый, удаленный, ограниченный или доступный только после входа контент в ответ не попадает.

Параметры Instagram Posts API

ПараметрыОбязательныйОписание
usernamesОбязательныйПубличные имена пользователей Instagram без @, разделенные запятыми или переводами строки.
results_limitНеобязательныйМаксимальное число записей, которое должна запросить задача сбора. Должно быть положительным целым числом.

Как использовать Instagram Posts API

Отправьте публичные имена пользователей как асинхронную задачу, опрашивайте ее по ID задачи, затем читайте нормализованные записи публикаций с курсорной пагинацией.

  1. Подготовьте одно или несколько публичных имен пользователей Instagram без @.
  2. Отправьте usernames и необязательный results_limit методом POST на /v1/instagram/posts.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, если есть еще записи.
curl -X POST "https://api.socq.ai/v1/instagram/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Сценарии использования Instagram Posts API

  • Сбор публикаций профилей: Собирайте публичные публикации выбранных имен пользователей Instagram в нормализованные записи со ссылками на медиафайлы и стабильными идентификаторами.
  • Исследование контента: Собирайте публичные подписи, метки времени, хештеги и видимые счетчики вовлеченности публикаций, которые изучают исследовательские или аналитические команды.
  • Архивирование: Храните метаданные публичных публикаций, ссылки на медиафайлы, контекст автора, исходные URL и время сбора для очередей проверки, систем отчетности или внутренних записей.
  • Контроль качества кампаний: Проверяйте публичные публикации, возвращенные для имен пользователей авторов или брендов, прежде чем объединять выбранные записи с данными кампании.
  • Обогащение контента профилей: Объединяйте ID публикаций, данные авторов, подписи, ссылки на медиафайлы и видимые метрики с существующими записями профилей или кампаний.

Практические советы по Instagram Posts API

  • Отправляйте имена пользователей без префикса @ и используйте небольшие пакеты, пока проверяете новый рабочий процесс.
  • Учитывайте, что в некоторых публичных записях может не быть ссылок на медиафайлы, счетчиков или меток времени — это зависит от доступности источника.
  • При ответах 429, проверках (challenge) или временных блокировках применяйте умеренные повторные попытки с задержкой, а не повторяйте запросы агрессивно.
  • Используйте Reels API для сбора роликов Reels профиля, Search API для поиска и Comments API, когда важны публичные ветки комментариев.
  • Не стройте рабочие процессы на закрытых аккаунтах, историях, актуальном или полях, доступных только после входа.

Помимо Instagram Posts API, используйте эти API, когда нужен другой тип публичных данных Instagram.

  • Instagram Reels API — Собирайте публичные Reels, медиа, аудио, хештеги, упоминания и вовлеченность по имени пользователя.
  • Instagram Comments API — Собирайте публичные комментарии, авторов, метки времени, лайки и ответы по URL публикаций.
  • Instagram Profiles API — Получайте по имени пользователя публичные данные профиля, описание, ссылки, признаки аккаунта, категории и видимые счетчики.
  • Instagram Tagged Posts API — Собирайте публичные публикации с отметкой выбранных профилей: авторы, медиа, упоминания, контекст отмеченного пользователя и вовлеченность.
  • Instagram Transcript API — Извлекайте текст расшифровки, язык, формат, URL источника и shortcode по URL публичных публикаций или Reels.
  • Instagram Post Info API — Получайте данные по известным URL публичных публикаций, Reels или старых IGTV: подписи, данные автора, медиа, метки времени, видимая вовлеченность и контекст входных данных.

Другие платформы

Объединяйте данные Instagram с публичными данными других поддерживаемых соцсетей.

Instagram Posts API — FAQ

Instagram Posts API собирает общедоступные публикации по одному или нескольким именам пользователей Instagram. Он возвращает нормализованные подписи, данные автора, ссылки на медиафайлы, хештеги, упоминания, метки времени и видимые счетчики вовлеченности.

Текущий эндпоинт принимает одно или несколько публичных имен пользователей. URL отдельной публикации или шорткод в качестве входных данных запроса не принимаются.

Да. Если публичные результаты содержат данные о медиа, нормализованные элементы могут включать URL изображений или видео, миниатюры, размеры и длительность видео.

Типичные поля: ID публикации, шорткод, канонический URL, автор, подпись, время публикации, видимые метрики, ссылки на медиафайлы, хештеги, упоминания и время сбора.

Нет. Закрытые, удаленные, ограниченные или доступные только после входа публикации могут вернуть ограниченные данные или ни одной записи, потому что эндпоинт собирает только общедоступные результаты.

Он может возвращать публичные ссылки на медиафайлы, если они есть в публичных результатах. Клиентам всё равно следует обрабатывать отсутствующие, истекающие или ограниченные URL медиафайлов, потому что доступность зависит от типа публикации и ответа источника.

Используйте умеренную частоту запросов и небольшие пакеты имен пользователей, делайте задержку после ответов 429 или проверок (challenge) и повторяйте запрос позже, если публичный источник временно недоступен.