instagram/
post-likers

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

Instagram Post Likers API

URL публикации на входе
Список лайкнувших
До 1 000 аккаунтов
0,3 кредита за результат
Готово
Готово

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

README

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

Instagram Post Likers

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

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

  • Лайкнувшие по ссылке на публикациюВставьте URL публикации, Reels или IGTV и получите аккаунты, которые Instagram показывает как поставившие лайк.
  • Основные данные профиля каждого лайкнувшегоДля каждого лайкнувшего в related_actor есть ID пользователя, имя пользователя, отображаемое имя, ссылка на профиль, аватар и признаки верификации и закрытого аккаунта.
  • Записи с пометкой лайкаКаждая запись содержит relationship = liker, поэтому лайкнувшие хранятся рядом с данными подписчиков и подписок в одном пайплайне без дополнительного сопоставления.

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

ПараметрыОбязательныйОписание
urlОбязательныйСсылка на публичную публикацию, Reels или видео IGTV.
results_limitНеобязательныйСколько лайкнувших вернуть — от 1 до 1 000. По умолчанию 100.

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

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

  1. Скопируйте URL публичной публикации, Reels или видео IGTV.
  2. Отправьте url и необязательный results_limit методом POST на /v1/instagram/post-likers.
  3. Дождитесь, пока GET /v1/tasks/{task_id} сообщит status succeeded.
  4. Читайте лайкнувших из results.items, переходя по results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/post-likers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/p/DRhvwVLAHAG/","results_limit":100}'

# Each result is one liker, with the account details in related_actor.
# Read them from GET /v1/tasks/{task_id}.

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

  • Анализ аудитории кампании: Получите лайкнувших спонсорскую публикацию, чтобы увидеть, какие аккаунты она охватила на самом деле.
  • Поиск постоянных поклонников: Собирайте лайкнувших несколько публикаций и сопоставляйте их ID пользователей, чтобы найти тех, кто ставит лайки снова и снова.
  • Заметные вовлеченные аккаунты: Фильтруйте лайкнувших по is_verified, чтобы выделить авторов, бренды и публичных персон, которым понравилась публикация.

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

  • Сопоставляйте лайкнувших разные публикации по related_actor.id — он не меняется, даже если человек сменил имя пользователя.
  • Общее число лайков публикации берите из Instagram Post Info, а список лайкнувших считайте теми аккаунтами, которые Instagram решает показать.
  • Передавайте имена пользователей лайкнувших в Instagram Profiles, если к ним нужны число подписчиков и описание профиля.

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

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

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

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

Instagram Post Likers API — FAQ

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

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

Да. Принимается любая ссылка на публичную публикацию, Reels или IGTV, в том числе ссылки, где имя аккаунта стоит перед /p/ или /reel/.

В related_actor.username, а поле url записи ведет прямо на профиль лайкнувшего.

Каждый возвращенный лайкнувший аккаунт стоит 0,3 кредита.