API комментариев Instagram

Комментарии Instagram по ID публикации — API

Получайте публичные комментарии к публикации Instagram по её числовому media ID. Метод подходит для мониторинга обсуждений, модерации, исследований аудитории и отчётности.

Передайте media_id публикации и при необходимости cursor для следующей страницы. Для новой интеграции используйте V2 с нормализованной структурой ответа.

Метод GET
Сущность Комментарии
Версии 2
Что делает этот эндпоинт

Что можно сделать с этим API-методом

Сначала оцените результат и сценарии применения, затем переходите к параметрам и рабочему примеру запроса.

Результат запроса

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

Когда использовать

Передайте media_id публикации и при необходимости cursor для следующей страницы. Для новой интеграции используйте V2 с нормализованной структурой ответа.

Типовые сценарии использования

Мониторинг обсуждений

Собирайте реакцию аудитории под конкретными публикациями для бренд-мониторинга и исследований.

Модерация комментариев

Передавайте комментарии во внутренние очереди проверки, разметки и контроля качества коммуникаций.

Отчёты по контенту

Дополняйте аналитику публикаций текстами комментариев, авторами и сигналами вовлечённости.

Доступные версии

Версия ответа

Обе версии решают одну и ту же задачу и принимают одинаковые параметры. Переключатель нужен, чтобы сравнить структуру ответа и выбрать версию, которую ожидает ваш клиент.

Версия ответа V2

Переключайте версии на этой странице, чтобы сравнивать структуру ответа без смены URL инструкции.

Что остается одинаковым

Аутентификация, обязательные параметры и форма запроса одинаковы для V1 и V2. Версия задаётся в пути запроса и определяет структуру ответа.

Что меняется между версиями

Главное отличие — envelope ответа. Для новых интеграций лучше использовать V2, а V1 оставлять только для совместимости с уже существующей клиентской интеграцией.

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

Как вызвать метод

Для обеих версий используется один заголовок API-ключа и одинаковые параметры строки запроса. Ниже сначала показаны общие параметры, затем путь и примеры кода для выбранной версии.

Входные параметры

Общие параметры
Параметр Обязателен Тип Пример Описание
media_id Да str 25025320 Числовой ID публикации Instagram, для которой нужно получить данные.
cursor Нет str | None QVFB... Курсор следующей страницы из предыдущего ответа. Не передавайте его для первой страницы.

Путь запроса для выбранной версии

V2

Версию имеет смысл выбирать, когда вы копируете точный путь эндпоинта, пример URL и фрагмент кода. Список параметров выше при этом остается тем же самым.

GET /api/v2/instagram.com/comments/by-media-id

Нормализованный формат

Примеры кода

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/instagram.com/comments/by-media-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'media_id=25025320' \
  # Optional parameters:
  # --data-urlencode 'cursor=QVFB...'
Пример ответа

Пример ответа по версиям

Пример сокращён до ключевых полей и первых элементов коллекций, чтобы структуру ответа можно было быстро оценить. Переключатель версии меняет формат JSON.

Пример ответа

V2 — JSON

Заглушка

Для версии V2 проверенный пример пока недоступен. Заглушка сохраняет видимой стандартную структуру ответа.

{
  "success": true,
  "status": "ok",
  "data": {}
}
Что делать дальше

Продолжить оценку API-метода

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

Открыть страницу Instagram API

Сравните соседние сущности, группы API-методов и связанные инструкции перед внедрением.

Открыть страницу платформы

Сравнить стоимость API-методов

Посмотрите, где этот API-метод находится в публичной таблице цен, прежде чем масштабировать использование.

Открыть тарифы

Проверить правила интеграции

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

Открыть документацию
FAQ

Вопросы, которые команды задают до внедрения

Эти ответы помогают понять, подходит ли API-метод под ваш сценарий, выбор версии и запуск.

Где взять media ID публикации Instagram?

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

Как загрузить все комментарии, если они не помещаются в один ответ?

Выполните первый запрос без cursor, затем передавайте cursor из ответа в следующий запрос. Продолжайте, пока ответ не перестанет возвращать курсор следующей страницы.

Какую версию использовать для новой интеграции?

Используйте V2: поля нормализованы и удобнее для стабильной продуктовой модели. V1 оставлен для совместимости с интеграциями, которые разбирают исходную структуру Instagram.

Списываются ли кредиты за неуспешный ответ?

Нет. Кредиты списываются за успешный ответ API. Актуальную стоимость этого и других методов смотрите в каталоге стоимости.