instagram/
followers-count

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

Instagram Followers Count API

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

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

README

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

Instagram Followers Count

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

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

  • Видимые счетчики профиляПолучайте видимое число подписчиков, подписок и публикаций из общедоступных профилей Instagram.
  • Имена пользователей и URL на входеПринимает одно или несколько публичных имен пользователей, URL профилей или пакет с любым из этих типов входных данных.
  • Только счетчикиВозвращает записи со счетчиками, а не полные списки подписчиков или подписок.
  • Поля данных профиляДобавляет к каждой записи со счетчиками публичное отображаемое имя, URL профиля, аватар, статус верификации и статус приватности.
  • Только публичные данныеДанные закрытых, удаленных, ограниченных или доступных только после входа профилей в ответ не попадают.

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

ПараметрыОбязательныйОписание
usernamesНеобязательныйПубличные имена пользователей Instagram без @, разделенные запятыми или переводами строки. Укажите usernames или urls.
urlsНеобязательныйНеобязательные URL публичных профилей Instagram. Укажите urls или usernames.
results_limitНеобязательныйМаксимальное число записей, которое должна запросить задача сбора. Должно быть положительным целым числом.

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

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

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

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

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

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

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

  • Используйте этот эндпоинт только для счетчиков; если нужны и записи публичного контента, обращайтесь к Posts или Reels API.
  • Сохраняйте collected_at для каждой записи: публичные счетчики могут меняться между обновлениями.
  • Используйте умеренные размеры пакетов и повторяйте запросы с задержкой, если публичные результаты временно недоступны.
  • Считайте отсутствие полей posts_count, avatar или верификации обычной изменчивостью публичных результатов.
  • Не стройте рабочие процессы на закрытых профилях, полных списках подписчиков или данных Instagram, доступных только после входа.

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

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

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

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

Instagram Followers Count API — FAQ

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

Нет. Этот API предназначен для счетчиков, таких как followers_count и following_count, а не для выгрузки отдельных подписчиков или подписок.

Типичные поля: ID профиля, username, profile_url, display_name, avatar, followers_count, following_count, posts_count, verified, private и collected_at. Некоторые необязательные поля могут отсутствовать, если публичный профиль их не показывает.

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

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

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

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