instagram/
following-list

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

Instagram Following List API

Связи по подпискам
Публичные профили
Пакет имен пользователей
0,3 кредита за результат
Готово
Готово

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

README

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

Instagram Following List

Записи Instagram Following List — это публичные профили, на которые подписано исходное имя пользователя, с нормализованными данными профиля, URL профилей, признаками видимости и контекстом связи. Повторные сборы позволяют делать снимки связей, а collected_at, source_username и position фиксируют, когда и где была замечена каждая запись.

Возможности Instagram Following List API

  • Пакет исходных имен пользователейОтправляйте одно или несколько публичных имен пользователей Instagram в одной задаче, без начального символа @.
  • Происхождение связиСохраняет source_username, relationship и position в extra, чтобы каждый профиль можно было отследить до исходного аккаунта.
  • Нормализованные данные профиляПолучайте ID профиля, имя пользователя, отображаемое имя, канонический URL профиля, аватар и публичные признаки верификации или приватности, если они доступны.
  • Видимые метрики аккаунтаИспользуйте возвращенное число подписчиков, подписок и публикаций, если эти публичные значения есть в собранной записи.
  • Асинхронная постраничная выдачаОтправляйте сбор вне потока запроса, опрашивайте статус задачи и листайте нормализованные результаты с помощью next_cursor.

Параметры Instagram Following List API

ПараметрыОбязательныйОписание
usernamesОбязательныйОдно или несколько публичных имен пользователей Instagram без @, разделенных запятыми или переводами строки.
results_limitНеобязательныйМаксимальное число профилей подписок, запрашиваемых для каждого исходного имени пользователя; целое число от 1 до 2 000, по умолчанию 100.

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

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

  1. Подготовьте одно или несколько публичных имен пользователей Instagram без начального символа @.
  2. Отправьте usernames и необязательный results_limit от 1 до 2 000 методом POST на /v1/instagram/following-list.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /v1/tasks/{task_id}?limit=50 и продолжайте с results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/following-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

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

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

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

  • Удаляйте начальный @ из каждого имени пользователя перед отправкой; входные данные провайдера нормализуются до простых имен пользователей.
  • Начинайте с небольшого results_limit и увеличивайте его, только если сценарию нужен больший набор видимых связей.
  • Храните ID профиля вместе с extra.source_username: один и тот же профиль может встречаться у нескольких исходных аккаунтов.
  • Считайте отсутствие аватаров, метрик аккаунта, признаков верификации или позиций обычной изменчивостью публичных результатов.
  • Закладывайте обработку пустых или частичных результатов: закрытые, ограниченные, удаленные или доступные только после входа связи не поддерживаются.

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

  • Instagram Followers Count API — Получайте публичные данные профиля и видимое число подписчиков, подписок и публикаций.
  • Instagram Posts API — Собирайте публичные публикации, медиа, хештеги, упоминания, метки времени и вовлеченность по имени пользователя.
  • Instagram Profiles API — Получайте по имени пользователя публичные данные профиля, описание, ссылки, признаки аккаунта, категории и видимые счетчики.
  • Instagram Followers List API — Собирайте публичные записи профилей подписчиков с контекстом исходного аккаунта и связи.
  • Instagram Similar Accounts API — Получайте список аккаунтов, которые Instagram предлагает как похожие на заданный: имена пользователей, имена, аватары и статус верификации.
  • Instagram Post Likers API — Получайте аккаунты из видимого списка лайкнувших публикацию по ее URL: имена пользователей, имена, аватары и статус верификации.

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

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

Instagram Following List API — FAQ

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

Following возвращает отдельные публичные записи профилей из видимого списка подписок, а Followers Count — общее число подписчиков и публикаций на уровне профиля без списка связей.

Записи могут включать ID, имя пользователя, отображаемое имя, URL профиля, URL аватара, признаки верификации и приватности, видимые метрики, collected_at, source_username, relationship и position.

Да. Отправьте одно или несколько публичных имен пользователей в массиве usernames; source_username показывает, какой входной аккаунт дал каждую запись связи, если это поле доступно.

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

Читайте завершенную задачу с limit до 500 записей на страницу, затем передавайте results.next_cursor в следующем запросе, пока results.has_more равно true.

Успешные нормализованные результаты оплачиваются по 0,3 кредита за запись без базовой платы; для пустого результата действует правило только базовой платы, поэтому он стоит ноль кредитов.