instagram/
post-info

Получайте публичные публикации, ролики Reels или устаревшие элементы IGTV Instagram по известным URL: подписи, данные автора, медиафайлы, метки времени и видимая вовлеченность.

Instagram Post Info API

Запрос по прямому URL
Метаданные публикаций
Публичный контент
0,5 кредита за результат
Готово
Готово

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

README

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

Instagram Post Info

Записи Instagram Post Info описывают отдельные публичные публикации, ролики Reels или устаревшие элементы IGTV через подпись, данные автора, ссылки на медиафайлы, время публикации, видимую вовлеченность и тип продукта в источнике. Эти поля помогают обогащать данные по известным URL, каталогизировать контент, делать снимки вовлеченности и сравнивать форматы.

Возможности Instagram Post Info API

  • Запрос по прямому URL контентаОбрабатывает известные публичные URL Instagram вида /p/, /reel/ и /tv/ без сбора профиля или поиска.
  • Подпись и контекст автораВозвращает публичный текст подписи с доступными ID автора, именем пользователя, отображаемым именем и ссылкой на аватар.
  • Медиа и вовлеченностьНормализует публичные ссылки на изображения или видео вместе с видимым числом лайков, комментариев, просмотров и воспроизведений.
  • Прослеживаемые нормализованные записиСохраняет отправленный URL и доступный тип продукта источника в каждой стандартизированной записи публикации.

Параметры Instagram Post Info API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательные URL контента Instagram, разделенные запятыми или переводами строки. Допустимые хосты — instagram.com и www.instagram.com; путь должен начинаться с /p/, /reel/ или /tv/.

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

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

  1. Подготовьте один или несколько публичных URL instagram.com, путь которых начинается с /p/, /reel/ или /tv/ и содержит шорткод контента.
  2. Отправьте urls методом POST на /v1/instagram/post-info.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте data.results.items из /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/post-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"urls\":[\"$INSTAGRAM_POST_URL\"]}"

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

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

  • Обогащение известных публикаций: Добавляйте подпись, данные автора, медиафайлы, время публикации и видимую вовлеченность к сохраненному списку URL контента Instagram.
  • Нормализация каталога контента: Превращайте смешанные ссылки на публикации, Reels и устаревшие элементы IGTV в единообразные записи со стабильными идентификаторами и контекстом источника.
  • Снимки публичной вовлеченности: Фиксируйте видимые счетчики лайков, комментариев, просмотров и воспроизведений выбранного контента на момент сбора.
  • Сравнение форматов контента: Используйте поля медиа и тип продукта источника, чтобы сравнивать доступные метаданные известных публикаций ленты, Reels и устаревших элементов IGTV.

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

  • Указывайте реальный шорткод после /p/, /reel/ или /tv/: путь только с префиксом может пройти проверку формата, но не вернуть записи.
  • Сохраняйте extra.input_url, чтобы сопоставлять результаты задачи с несколькими URL с входными данными; повторяющиеся URL объединяются, и каждый уникальный URL дает не больше одной записи.
  • Будьте готовы к тому, что записей окажется меньше, чем отправленных URL, и считайте поля автора, метрик, медиа, времени и типа продукта необязательными, если контент недоступен или не опубликован открыто.

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

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

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

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

Instagram Post Info API — FAQ

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

Отправляйте URL instagram.com или www.instagram.com, путь которых начинается с /p/, /reel/ или /tv/. Указывайте настоящий шорткод контента после префикса: путь только с префиксом может пройти проверку, но не вернуть записи.

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

Повторяющиеся входные значения объединяются, а закрытый, удаленный, ограниченный, некорректный или иначе недоступный контент может не дать записи. Каждый уникальный URL возвращает не больше одного элемента.

Каждый сохраненный результат стоит 0,5 кредита без базовой платы за задачу. За задачу без сохраненных записей плата за результаты не взимается.