instagram/
followers-list

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

Instagram Followers List API

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

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

README

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

Instagram Followers List

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

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

  • Сбор подписчиков нескольких аккаунтовОтправьте одно или несколько имен пользователей Instagram и запросите профили подписчиков каждого исходного аккаунта в одной асинхронной задаче.
  • Нормализованные данные подписчиковВозвращает доступные ID профиля, имя пользователя, отображаемое имя, производный URL профиля и публичное фото профиля для каждой строки подписчика.
  • Признаки видимости и источникаСохраняет признаки верификации и закрытого аккаунта, а также исходное имя пользователя и тип связи, если эти значения доступны.
  • Контекст наблюдаемого спискаСохраняет позицию в источнике и время парсинга Actor, если они доступны, а время сбора SocQ используется как резервная метка времени.
  • Лимит результатов на имя пользователяresults_limit применяется к каждому отправленному имени пользователя отдельно; по умолчанию 100, допустимый диапазон — от 1 до 2 000.

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

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

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

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

  1. Подготовьте одно или несколько публичных имен пользователей Instagram; начальный символ @ допускается и удаляется перед сбором.
  2. Отправьте usernames и необязательный results_limit методом POST на /v1/instagram/followers-list и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
  4. Читайте data.results.items и переходите по next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/followers-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 data.results.items and follow next_cursor while has_more is true

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

  • Выборки публичной аудитории: Формируйте ограниченную выборку имен пользователей, отображаемых имен, ссылок на профили, признаков видимости и наблюдаемых позиций подписчиков выбранного публичного аккаунта.
  • Проверка пересечений между аккаунтами: Группируйте строки по extra.source_username и сравнивайте ID или имена пользователей подписчиков, чтобы находить профили, которые встречаются у нескольких отправленных аккаунтов.
  • Очереди обогащения профилей: Отбирайте возвращенные имена пользователей и передавайте их в Instagram Profiles, когда сценарию нужны описание профиля или видимые счетчики профиля.
  • Снимки списков связей: Храните данные подписчика, исходное имя пользователя, наблюдаемую позицию и collected_at, чтобы последующие выборки публичного списка можно было различать.

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

  • При отправке нескольких имен пользователей оценивайте запрошенный объем как число имен, умноженное на results_limit: лимит и оценка кредитов применяются к каждому исходному аккаунту.
  • Если исходное имя пользователя начинается с @, его можно отправить без изменений: маппер провайдера удаляет начальные символы @ перед запуском Actor.
  • При сравнении аккаунтов сохраняйте extra.source_username: один и тот же профиль подписчика может встречаться в нескольких исходных списках, а удаление дублей между источниками не гарантируется.
  • Если position есть, считайте его наблюдаемым значением в списке, а не стабильным рейтингом или мерой силы связи.
  • Если публичный источник вернул меньше строк, чем запрошено, сохраните частичный результат и зафиксируйте collected_at; приватность, доступность аккаунта, пагинация источника и лимиты Actor могут уменьшить выдачу.

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

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

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

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

Instagram Followers List API — FAQ

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

usernames обязателен — это непустой массив непустых строк. results_limit необязателен, по умолчанию равен 100 на имя пользователя и принимает целые числа от 1 до 2 000.

Запись может содержать ID профиля, имя пользователя, отображаемое имя, производный URL профиля, фото профиля, признаки верификации и приватности, время сбора и поля extra с исходным именем пользователя, типом связи и наблюдаемой позицией.

Нет. Он возвращает отдельные строки публичных профилей подписчиков; если нужно видимое общее число подписчиков, подписок и публикаций профиля, используйте Instagram Followers Count API.

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

results_limit — это запрошенный максимум, а не гарантия полноты. Приватность профилей, доступность аккаунтов, лимиты Actor, пагинация источника и текущие границы публичного списка подписчиков могут уменьшить итоговое число.

Каждый возвращенный профиль подписчика стоит 0,3 кредита SocQ. Оценка рассчитывается как число имен пользователей, умноженное на results_limit, а за пустой набор результатов плата не взимается.