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

Демография подписчиков 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 для подключённого аккаунта.

100 followers

Ниже этого порога follower_demographics для аккаунта не возвращается.

100 engagements

Столько взаимодействий нужно за временной период, прежде чем вернётся engaged_audience_demographics.

Top 45

Демографические метрики возвращают только первые 45 значений, поэтому мелкие города и страны выпадают.

19 Aug 2024

Когда last_14_days, last_30_days, last_90_days и prev_month перестали работать для engaged_audience_demographics во всех версиях.

48 hours

Как долго могут запаздывать данные, на которых основаны метрики аккаунта.

Какие демографические метрики есть?

Две в справочнике Meta по инсайтам аккаунта, обе читаются через GET /<IG_ID>/insights, и два старых набора, которые ещё запрашивает старый код:

  • follower_demographics: демографические характеристики подписчиков аккаунта.
  • engaged_audience_demographics: то же для вовлечённой аудитории, то есть аккаунтов, которые взаимодействовали с его контентом.
  • Обе: period lifetime, metric_type total_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:

Followers by country, this month
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:

The response shape, broken down by country
{
  "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 могут сказать, какие страны, города или возрастные группы подписаны на аккаунт.

get_social_insights arguments for followers by age
{
  "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 взаимодействий за временной период.
Настройка с EasyCoexistence

От 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, и он обязателен.

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

Статистика Instagram через API: метрики аккаунта и постовМетрики, которые API Instagram возвращает для аккаунта и каждого поста, Reels и Stories, с порогами Meta, задержками и переименованными метриками.Аналитика Reels в Instagram через APIМетрики Reels из API Instagram: views, reach, likes, shares, saved, время просмотра и доля пропусков, а также снятые метрики и их замены.Инсайты сторис в Instagram через APIМетрики сторис из API Instagram: охват, просмотры, ответы, навигация по нажатиям и выходу, срок их доступности и почему приходит ошибка 10.Устаревшие метрики Instagram API: impressions и plays заменены на viewsМетрики Instagram, которые Meta упразднила в 2025 году: impressions, plays, video_views. Даты, замена каждой и правки в коде.Какие аккаунты Instagram работают с API: бизнес, креатор или личныйAPI Instagram работает с профессиональными аккаунтами: бизнес и креатор. Какой выбрать, что меняется при переходе и как переключиться в приложении.

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

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

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

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