instagram/
comments

Собирайте публичные комментарии Instagram по одному или нескольким URL публикаций: нормализованный текст, данные автора, метки времени, ссылки на публикацию и видимое число лайков и ответов.

Instagram Comments API

Комментарии
Публичные данные
URL публикаций
0,3 кредита за результат
Готово
Готово

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

README

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

Instagram Comments

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

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

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

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

ПараметрыОбязательныйОписание
urlsОбязательныйURL публичных публикаций Instagram, разделенные запятыми или переводами строки.

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

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

  1. Подготовьте один или несколько URL публичных публикаций Instagram.
  2. Отправьте urls методом POST на /v1/instagram/comments.
  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/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.instagram.com/p/POST_CODE/"]}'

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

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

  • Мониторинг настроений потребителей: Анализируйте текст публичных комментариев, эмодзи и видимые сигналы вовлеченности, чтобы отслеживать реакцию аудитории на выбранные публикации.
  • Поиск трендов и возможностей: Находите в публичных обсуждениях новые темы, отзывы о продуктах, запросы функций, повторяющиеся вопросы и первые признаки спроса.
  • Анализ реакции на кампании: Сравнивайте публичную реакцию на публикации кампаний, креативы, запуски или анонсы с помощью единообразных записей комментариев.
  • Мониторинг бренда и репутации: Отслеживайте похвалу, жалобы, повторяющиеся претензии и изменения в реакции аудитории вокруг выбранных публичных публикаций.
  • Исследование конкурентов и авторов: Изучайте публичные обсуждения под публикациями конкурентов и авторов, чтобы сравнивать темы, вопросы и видимую вовлеченность.
  • Поиск вовлеченной аудитории: Используйте публичный контекст автора, лайки комментариев и число ответов, чтобы находить комментарии и участников, которые двигают обсуждение.
  • Аналитика и пайплайны данных: Загружайте нормализованные записи комментариев в процессы анализа текста, отчетности, аналитических панелей или хранилищ данных.

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

  • Отправляйте канонические URL публикаций Instagram, которые хотите проанализировать.
  • Начните с небольшого пакета URL, чтобы проверить покрытие, прежде чем увеличивать число отправляемых публикаций.
  • Сохраняйте возвращенный task_id и после повторного входа или сбоя сети продолжайте опрашивать ту же задачу, а не отправляйте ее заново.
  • После успешного завершения задачи переходите по results.next_cursor, пока has_more не станет false, а не считайте первую страницу результатов полной.
  • Храните id комментария вместе с post_id, post_url, parent_comment_id и input_url для надежного объединения и удаления дублей.
  • Стройте схемы последующей обработки вокруг id комментария, text, author, created_at, collected_at и ссылок на источник, а media и metrics используйте как поля обогащения.
  • Используйте replies_count, чтобы ранжировать активные обсуждения, и parent_comment_id, чтобы сохранять связи между комментариями.
  • При временных сбоях применяйте ограниченную экспоненциальную задержку и соблюдайте retry-after, если он есть в ответе 429.
  • Проверяйте и экранируйте текст комментариев перед выводом на экран или передачей в автоматизированный анализ.
  • Используйте Posts API, если вам также нужны текст родительской публикации, медиафайлы, время публикации или контекст вовлеченности на уровне публикации.

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

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

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

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

Instagram Comments API — FAQ

Instagram Comments API собирает публично видимые комментарии по одному или нескольким URL публикаций Instagram. Он возвращает нормализованный текст, данные автора, метки времени, ссылки на публикацию, медиафайлы и видимое число лайков и ответов.

Отправьте один или несколько канонических URL публикаций Instagram в массиве urls. Указывайте каждый URL с новой строки или разделяйте URL запятыми.

Каждая нормализованная запись содержит id, text, author, url, metrics, media, created_at, collected_at и ссылки на источник, например post_id, post_url, parent_comment_id и input_url.

Да. Передайте несколько URL публичных публикаций в массиве urls одного запроса.

Используйте replies_count, чтобы сравнивать активность обсуждений, и parent_comment_id, чтобы связать комментарий с родительским контекстом.

Используйте текст комментариев, контекст автора, метки времени, лайки, число ответов и ссылки на публикации для мониторинга настроений, поиска трендов, анализа кампаний, исследования аудитории и отчетности.

Подключать аккаунт не нужно. Авторизуйте запросы своим API-ключом и отправьте URL публикаций Instagram, которые хотите собрать.

Читайте нормализованные JSON-результаты через эндпоинт задачи, затем передавайте их в аналитику, аналитические панели, базы данных, задания обработки текста или пайплайны отчетности.

После успешного завершения задачи читайте /v1/tasks/{task_id}?limit=50 и продолжайте с results.next_cursor, пока has_more не станет false.

Каждый возвращенный комментарий стоит 0,3 кредита, а за пустой результат плата не взимается. В сведениях о задаче показано итоговое списание по фактическому числу результатов.