Демография подписчиков Instagram через API
Эндпоинт аналитики аккаунта Instagram возвращает демографию подписчиков при metric=follower_demographics, period=lifetime, metric_type=total_value, временном периоде (timeframe) и разбивке по возрасту, полу, городу или стране. engaged_audience_demographics делает то же самое для аккаунтов, которые взаимодействовали с контентом. Meta возвращает только первые 45 значений; для данных о подписчиках нужно 100 подписчиков, а для данных о вовлечённой аудитории 100 взаимодействий за временной период.
easyCoexistence читает демографию подписчиков и вовлечённой аудитории Instagram через get_social_insights, поэтому Claude, ChatGPT или ваш собственный код могут спросить, какие страны, города или возрастные группы подписаны на аккаунт, и получить цифры Meta для подключённого аккаунта.
Ниже этого порога follower_demographics для аккаунта не возвращается.
Столько взаимодействий нужно за временной период, прежде чем вернётся engaged_audience_demographics.
Демографические метрики возвращают только первые 45 значений, поэтому мелкие города и страны выпадают.
Когда last_14_days, last_30_days, last_90_days и prev_month перестали работать для engaged_audience_demographics во всех версиях.
Как долго могут запаздывать данные, на которых основаны метрики аккаунта.
Какие демографические метрики есть?
Две в справочнике Meta по инсайтам аккаунта, обе читаются через GET /<IG_ID>/insights, и два старых набора, которые ещё запрашивает старый код:
follower_demographics: демографические характеристики подписчиков аккаунта.engaged_audience_demographics: то же для вовлечённой аудитории, то есть аккаунтов, которые взаимодействовали с его контентом.- Обе: period lifetime,
metric_typetotal_value, временной период и разбивка по возрасту, городу, стране или полу. audience_gender_age,audience_locale,audience_countryиaudience_city: выведены из употребления 11 декабря 2023 года.reached_audience_demographics: упоминается в журнале изменений Meta за 2024 год, но отсутствует в её текущей таблице метрик.
Как запросить демографию подписчиков?
С метрикой, period=lifetime, metric_type=total_value, временным периодом и одной разбивкой. Параметр timeframe заменяет since и until, которые демографические метрики не поддерживают, и он обязателен. При Instagram Login токен должен иметь разрешения instagram_business_basic и instagram_business_manage_insights, а запрос идёт на graph.instagram.com:
GET https://graph.instagram.com/<IG_ID>/insights
?metric=follower_demographics
&period=lifetime
&timeframe=this_month
&breakdown=country
&metric_type=total_value
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>Как выглядит ответ?
Количества находятся в total_value.breakdowns. dimension_keys называет запрошенный временной период и разбивку, а каждый результат объединяет dimension_values, временной период и одно значение разбивки с количеством. В примере Meta для вовлечённой аудитории по стране страны возвращаются двухбуквенными кодами, такими как US и ES:
{
"data": [
{
"name": "follower_demographics",
"period": "lifetime",
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"total_value": {
"breakdowns": [
{
"dimension_keys": ["timeframe", "country"],
"results": [
{ "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> },
{ "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> }
]
}
]
},
"id": "<IG_ID>/insights/follower_demographics/lifetime"
}
]
}Какие временные периоды работают?
Справочник Meta перечисляет last_14_days, last_30_days, last_90_days, prev_month, this_month и this_week для обеих метрик, а для вовлечённой аудитории описывает this_month как последние 30 дней, а this_week как последние 7. Для engaged_audience_demographics первые четыре перестали работать начиная с v20.0 и во всех версиях 19 августа 2024 года, поэтому используйте this_week или this_month. В той записи журнала изменений follower_demographics не упомянут.
Какие пороги и ограничения действуют?
Справочник Meta по инсайтам аккаунта устанавливает для демографических метрик такие правила:
follower_demographicsне возвращается для аккаунта с менее чем 100 подписчиками.engaged_audience_demographicsне возвращается при менее чем 100 взаимодействиях за временной период.- Возвращаются только первые 45 значений, поэтому мелкие города и страны выпадают.
- Учитываются только зрители с демографическими данными, поэтому значения в сумме могут быть меньше количества подписчиков.
- При отсутствии данных возвращается пустой набор, а не 0, и данные могут отставать до 48 часов.
- Разбивка, которую запрашиваемая метрика не поддерживает, проваливает весь вызов с ошибкой «An unknown error has occurred».
Работают ли демографические данные с Instagram Login?
Да. Meta открыла инсайты аккаунта и медиа для приложений Instagram Login 21 января 2025 года, а справочник по инсайтам аккаунта перечисляет Instagram Login с разрешениями instagram_business_basic и instagram_business_manage_insights и graph.instagram.com как хост. Аккаунт должен быть бизнес- или креатор-аккаунтом, как того требует Instagram Platform от Meta.
Как get_social_insights читает демографию?
Когда metrics задан как follower_demographics или engaged_audience_demographics, period как lifetime, а params содержит timeframe, breakdown и metric_type. easyCoexistence вызывает GET /<IG_ID>/insights для подключённого аккаунта с его токеном и возвращает ответ Meta, поэтому Claude или ChatGPT могут сказать, какие страны, города или возрастные группы подписаны на аккаунт.
{
"account_id": "<ACCOUNT_ID>",
"metrics": ["follower_demographics"],
"period": "lifetime",
"params": {
"timeframe": "this_month",
"breakdown": "age",
"metric_type": "total_value"
}
}Распространённые ошибки
- Передача since и until. Демографические метрики их не поддерживают: timeframe задаёт диапазон, и он обязателен.
- Использование last_30_days или last_90_days для вовлечённой аудитории. Эти временные периоды перестали работать для engaged_audience_demographics во всех версиях 19 августа 2024 года.
- Суммирование разбивки, чтобы получить количество подписчиков. Учитываются только зрители с демографическими данными и возвращаются только первые 45 значений, поэтому сумма получается меньше.
- Ожидание данных от небольшого аккаунта. Демография подписчиков требует 100 подписчиков, а вовлечённая аудитория 100 взаимодействий за временной период.
От US$ 9 до US$ 0,75 за подключение в месяц, с падением по мере добавления подключений, бесплатный пробный период 3 дня.
Часто задаваемые вопросы
Сколько подписчиков нужно аккаунту Instagram для демографии?
100. Ниже этого Meta не возвращает follower_demographics; engaged_audience_demographics требует 100 взаимодействий за временной период.
Почему Instagram возвращает только 45 городов?
Демографические метрики Meta возвращают только первые 45 значений, поэтому мелкие города и страны не попадают в ответ.
Что пришло на смену audience_gender_age в Instagram API?
follower_demographics с разбивкой по возрасту, полу, городу или стране. Meta вывела из употребления audience_gender_age, audience_locale, audience_country и audience_city 11 декабря 2023 года.
Можно ли использовать since и until с follower_demographics?
Нет. Демографические метрики не поддерживают since и until; вместо них диапазон задаёт параметр timeframe, и он обязателен.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на