Instagram Comments
Комментарии Instagram — это публичные отклики на публикации и ролики Reels с текстом, данными автора, метками времени, видимыми лайками, числом ответов, медиафайлами и ссылками на источник. Эти сигналы обсуждений помогают анализировать обратную связь, проверять модерацию, исследовать сообщества и готовить отчеты по кампаниям.
Возможности Instagram Comments API
- Сбор комментариев к нескольким публикациямСобирайте комментарии по одному или нескольким URL публичных публикаций Instagram в одном запросе.
- Нормализованные записи комментариевВозвращает ID комментариев, текст, данные автора, время публикации, время сбора и исходные URL в единой структуре.
- Видимые метрики обсужденияВыводит публичное число лайков и ответов в нормализованные поля metrics, чтобы сравнивать активность обсуждений.
- Прослеживаемый контекст обсужденияСохраняет ссылки на публикацию, родительский комментарий и отправленные входные данные для объединения, удаления дублей и анализа обсуждений.
- Только публичные данныеЗакрытые, ограниченные, удаленные и доступные только после входа комментарии в результаты не попадают.
Параметры Instagram Comments API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL публичных публикаций Instagram, разделенные запятыми или переводами строки. |
Как использовать Instagram Comments API
Отправьте URL публичных публикаций Instagram как асинхронную задачу, опрашивайте ее по ID задачи, затем читайте нормализованные записи комментариев с курсорной пагинацией.
- Подготовьте один или несколько URL публичных публикаций Instagram.
- Отправьте urls методом POST на /v1/instagram/comments.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /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, если вам также нужны текст родительской публикации, медиафайлы, время публикации или контекст вовлеченности на уровне публикации.
Связанные 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 Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API