Количество подписчиков и поля профиля 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; у числа подписчиков и публикаций в профиле инструмента нет.
Общее число пользователей Instagram, которые подписаны на аккаунт, поле, которое справочник Meta по IG User помечает как public.
Поля User из руководства Meta по Instagram Login, от id и user_id до followers_count и media_count.
Значение account_type для аккаунта Creator; бизнес-аккаунт возвращает Business.
Ниже этого порога Meta не возвращает для аккаунта ни follows_and_unfollows, ни follower_count в инсайтах.
Какие поля профиля возвращает Instagram Login?
Девять полей, которые руководство Meta по Instagram Login перечисляет для объекта User; читаются через GET /me со списком fields. Токену нужно право instagram_business_basic, а для последующих вызовов IG_ID аккаунта берётся из user_id, а не из id:
Как читать количество подписчиков?
Запросите followers_count у /me; справочник Meta переводит это в узел User аккаунта, к которому относится токен. Значение является накопительной суммой на момент вызова, поэтому панель управления, которая строит график, должна сама сохранять показание каждый день.
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.
От 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.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на