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 задачи, затем читайте нормализованные метрики профилей с курсорной пагинацией.
- Подготовьте одно или несколько публичных имен пользователей Instagram без @ или URL публичных профилей.
- Отправьте usernames или urls с необязательным results_limit методом POST на /v1/instagram/followers-count.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /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, доступных только после входа.
Связанные API
Помимо 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 Reels API
- Instagram Search API
- Instagram Comments API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Comment Replies API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API