ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Количество подписчиков и поля профиля Instagram через API

API Instagram возвращает количество подписчиков профессионального аккаунта в поле followers_count, рядом с follows_count, media_count, username, name, profile_picture_url и account_type. При Instagram Login запрос GET /me с этими полями читает их на graph.instagram.com с правом instagram_business_basic. В справочнике Meta по IG User также есть biography и website, а изменение числа подписчиков со временем берётся из инсайтов.

easyCoexistence подключает бизнес-аккаунт или аккаунт Creator в Instagram через Instagram Login, поэтому Claude, ChatGPT или ваш код читают охват, просмотры и подписки через get_social_insights, на официальном API Meta; у числа подписчиков и публикаций в профиле инструмента нет.

followers_count

Общее число пользователей Instagram, которые подписаны на аккаунт, поле, которое справочник Meta по IG User помечает как public.

9 fields

Поля User из руководства Meta по Instagram Login, от id и user_id до followers_count и media_count.

Media_Creator

Значение account_type для аккаунта Creator; бизнес-аккаунт возвращает Business.

100 followers

Ниже этого порога Meta не возвращает для аккаунта ни follows_and_unfollows, ни follower_count в инсайтах.

Какие поля профиля возвращает Instagram Login?

Девять полей, которые руководство Meta по Instagram Login перечисляет для объекта User; читаются через GET /me со списком fields. Токену нужно право instagram_business_basic, а для последующих вызовов IG_ID аккаунта берётся из user_id, а не из id:

idThe app user's app-scoped ID
user_idThe professional account's ID, the id in its webhook notifications
usernameThe account's username
nameThe profile name
account_typeBusiness or Media_Creator
profile_picture_urlThe profile picture's URL
followers_countAccounts following it
follows_countAccounts it follows
media_countMedia published on the account

Как читать количество подписчиков?

Запросите followers_count у /me; справочник Meta переводит это в узел User аккаунта, к которому относится токен. Значение является накопительной суммой на момент вызова, поэтому панель управления, которая строит график, должна сама сохранять показание каждый день.

Counts and username with Instagram Login
GET https://graph.instagram.com/me
  ?fields=user_id,username,followers_count,follows_count,media_count
  &access_token=<ACCESS_TOKEN>

{
  "user_id": "<IG_ID>",
  "username": "<USERNAME>",
  "followers_count": 1840,
  "follows_count": 312,
  "media_count": 97
}

Какие ещё поля перечисляет справочник Meta?

Справочник Meta по IG User, написанный сразу для трёх схем настройки, добавляет поля сверх девяти из руководства по Instagram Login. Некоторые он отмечает как доступные для аккаунтов, связанных со Страницей, у остальных нет пометки о входе:

  • biography: текст биографии профиля, помечено как public.
  • website: URL сайта аккаунта, помечено как public.
  • has_profile_pic: есть ли у аккаунта фото профиля.
  • is_published и legacy_instagram_user_id: для аккаунтов, связанных со Страницей; второе является ID, созданным для эндпоинтов Marketing API до v21.0.
  • shopping_product_tag_eligibility: настроен ли у аккаунта Instagram Shop.

Как отслеживать рост подписчиков?

Через инсайты аккаунта, а не через профиль. GET /<IG_ID>/insights с metric=follows_and_unfollows, metric_type=total_value и разбивкой follow_type возвращает аккаунты, которые подписались, и тех, кто отписался или покинул Instagram; при Instagram Login токену также нужно право instagram_business_manage_insights. Meta возвращает эти данные, как и follower_count, только для аккаунтов с не менее чем 100 подписчиками.

Может ли API показать, кто подписчики?

Нет. Справочник Meta по IG User отдаёт followers_count и follows_count числами и не содержит связи, которая вернула бы стоящие за ними аккаунты. Зато в инсайтах аккаунта есть follower_demographics с разбивкой по возрасту, городу, стране или полу, для аккаунтов с не менее чем 100 подписчиками.

Можно ли узнать число подписчиков чужого аккаунта?

Через Business Discovery, который Meta предлагает с Facebook Login и Unified Login: GET /<IG_ID>?fields=business_discovery.username(<USERNAME>){followers_count,media_count} возвращает их для другого бизнес-аккаунта или аккаунта Creator. Это чтение публичных полей чужого аккаунта, которые справочник IG User помечает: среди них biography, followers_count, id, media_count, username и website.

Как читать профиль через easyCoexistence?

list_social_accounts возвращает username, name и external_id каждого подключённого аккаунта; external_id и есть его IG_ID. У счётчиков профиля, followers_count, follows_count и media_count, нет инструмента, а токены Instagram не выдаются; вместо этого get_social_insights читает динамику аудитории: follows_and_unfollows, reach и views.

Распространённые ошибки

  • Ожидание списка подписчиков. Meta возвращает числа, а от 100 подписчиков также демографию, но не сами аккаунты.
  • График роста по одному followers_count. Это накопительная сумма; follows_and_unfollows в инсайтах отделяет новые подписки от отписок.
  • Проверка account_type на CREATOR. Аккаунт Creator возвращает Media_Creator, бизнес-аккаунт Business.
  • Использование id из /me как ID аккаунта. Руководство Meta привязывает к уведомлениям через вебхук и путям вида /<IG_ID>/media именно user_id, а не id.
Настройка с EasyCoexistence

От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений; первые 3 дня бесплатно.

Часто задаваемые вопросы

Возвращает ли API Instagram биографию профиля?

Да, как biography, которое справочник Meta по IG User отмечает как публичное. Девять полей User из руководства по Instagram Login его не включают, поэтому запрашивайте его через GET /me и проверяйте ответ в вашей настройке.

Почему follows_and_unfollows ничего не возвращает?

Meta не возвращает его для аккаунтов с менее чем 100 подписчиками.

Можно ли получить число подписчиков личного аккаунта?

Нет. API Meta работает с профессиональными аккаунтами, а Business Discovery читает только бизнес-аккаунты и аккаунты Creator.

Какое право нужно для числа подписчиков?

При Instagram Login: instagram_business_basic. Инсайты подписчиков добавляют instagram_business_manage_insights.

Читайте дальше

Instagram Business Discovery: чтение публикаций и подписчиков другого аккаунтаКак Business Discovery в Instagram читает подписчиков, профиль и публикации другого аккаунта по username и какой вход для этого нужен.Демография подписчиков Instagram через APIКак Instagram API возвращает follower_demographics и engaged_audience_demographics: разбивку по возрасту, полу, городу и стране, периоды и пороги.Статистика Instagram через API: метрики аккаунта и постовМетрики, которые API Instagram возвращает для аккаунта и каждого поста, Reels и Stories, с порогами Meta, задержками и переименованными метриками.ID пользователей Instagram: IG_ID, IGSID и ID в рамках приложенияКакой ID Instagram API за что отвечает: IG_ID профессионального аккаунта, IGSID человека, который пишет или комментирует, и ID приложения из /me.Получение постов аккаунта Instagram через APIКак API Instagram выводит посты аккаунта через GET /<IG_ID>/media: поля, элементы каруселей, курсоры, пагинация по дате и лента для сайта.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на