Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Dane demograficzne obserwujących na Instagramie przez API

Endpoint wglądów w konto Instagrama zwraca dane demograficzne obserwujących przy metric=follower_demographics, period=lifetime, metric_type=total_value, timeframe i podziale na wiek, płeć, miasto lub kraj. engaged_audience_demographics działa tak samo dla kont, które weszły w interakcję z treściami. Meta zwraca tylko 45 najwyższych wartości; dane o obserwujących wymagają 100 obserwujących, a dane o zaangażowanych 100 interakcji w danym okresie.

easyCoexistence odczytuje demografię obserwujących i zaangażowanych odbiorców na Instagramie przez get_social_insights, więc Claude, ChatGPT lub Twój własny kod mogą zapytać, które kraje, miasta czy grupy wiekowe obserwują konto, i otrzymać liczby Meta dla połączonego konta.

100 followers

Poniżej tego progu follower_demographics nie jest zwracane dla konta.

100 engagements

Tyle interakcji w danym okresie jest potrzebne, zanim zwrócone zostanie engaged_audience_demographics.

Top 45

Metryki demograficzne zwracają tylko 45 najwyższych wyników, więc mniejsze miasta i kraje znikają z zestawienia.

19 Aug 2024

Kiedy last_14_days, last_30_days, last_90_days i prev_month przestały działać dla engaged_audience_demographics we wszystkich wersjach.

48 hours

Jak długo dane leżące u podstaw metryk konta mogą być opóźnione.

Jakie są metryki demograficzne?

Dwie w dokumentacji metryk konta Meta, obie odczytywane przez GET /<IG_ID>/insights, oraz dwa starsze zestawy, o które nadal pyta stary kod:

  • follower_demographics: cechy demograficzne obserwujących konto.
  • engaged_audience_demographics: to samo dla zaangażowanych odbiorców, czyli kont, które weszły w interakcję z jego treściami.
  • Oba: period lifetime, metric_type total_value, timeframe oraz podział na wiek, miasto, kraj lub płeć.
  • audience_gender_age, audience_locale, audience_country i audience_city: wycofane 11 grudnia 2023.
  • reached_audience_demographics: wymieniona w changelogu Meta z 2024 roku, ale nieobecna w jej aktualnej tabeli metryk.

Jak zażądać danych demograficznych obserwujących?

Z metryką, period=lifetime, metric_type=total_value, timeframe i jednym podziałem. timeframe zastępuje since i until, których metryki demograficzne nie obsługują, i jest wymagany. Z Instagram Login token potrzebuje uprawnień instagram_business_basic i instagram_business_manage_insights, a wywołanie idzie do 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>

Jak wygląda odpowiedź?

Liczby są w total_value.breakdowns. dimension_keys podaje żądany okres i podział, a każdy wynik łączy dimension_values, okres i jedną wartość podziału z liczbą. Przykład Meta dla zaangażowanych odbiorców według kraju zwraca kraje jako dwuliterowe kody, na przykład US i 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"
    }
  ]
}

Które okresy działają?

Dokumentacja Meta wymienia last_14_days, last_30_days, last_90_days, prev_month, this_month i this_week dla obu metryk, a dla zaangażowanych odbiorców opisuje this_month jako ostatnie 30 dni, a this_week jako ostatnie 7. Dla engaged_audience_demographics pierwsze cztery przestały działać od v20.0 i we wszystkich wersjach 19 sierpnia 2024, więc używaj this_week lub this_month; ten wpis w changelogu nie wymienia follower_demographics.

Jakie progi i limity obowiązują?

Dokumentacja metryk konta Meta ustala dla metryk demograficznych te zasady:

  • follower_demographics nie jest zwracane dla konta z mniej niż 100 obserwującymi.
  • engaged_audience_demographics nie jest zwracane przy mniej niż 100 interakcjach w danym okresie.
  • Wracają tylko 45 najlepszych wyników, więc mniejsze miasta i kraje znikają.
  • Liczeni są tylko widzowie z danymi demograficznymi, więc wartości mogą sumować się do mniej niż liczba obserwujących.
  • Brak danych zwraca pusty zestaw, a nie 0, a dane mogą mieć opóźnienie do 48 godzin.
  • Podział, którego żądana metryka nie obsługuje, kończy całe wywołanie komunikatem An unknown error has occurred.

Czy dane demograficzne działają z Instagram Login?

Tak. Meta otworzyła wglądy w konto i media dla aplikacji Instagram Login 21 stycznia 2025, a jej dokumentacja metryk konta wymienia Instagram Login z uprawnieniami instagram_business_basic i instagram_business_manage_insights oraz graph.instagram.com jako host. Konto musi być kontem firmowym lub twórcy, zgodnie z wymogiem Instagram Platform Meta.

Jak get_social_insights odczytuje dane demograficzne?

Z metrics ustawionym na follower_demographics lub engaged_audience_demographics, period ustawionym na lifetime i params zawierającymi timeframe, breakdown i metric_type. easyCoexistence wywołuje GET /<IG_ID>/insights dla połączonego konta jego tokenem i zwraca odpowiedź Meta, dzięki czemu Claude lub ChatGPT mogą powiedzieć, które kraje, miasta czy grupy wiekowe obserwują konto.

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"
  }
}

Typowe błędy

  • Przekazywanie since i until. Metryki demograficzne ich nie obsługują: timeframe wyznacza zakres i jest wymagany.
  • Używanie last_30_days lub last_90_days dla zaangażowanych odbiorców. Te okresy przestały działać dla engaged_audience_demographics we wszystkich wersjach 19 sierpnia 2024.
  • Sumowanie podziału, by uzyskać liczbę obserwujących. Liczeni są tylko widzowie z danymi demograficznymi, a wracają tylko 45 najwyższych wartości, więc suma wypada niżej.
  • Oczekiwanie danych z małego konta. Dane demograficzne obserwujących wymagają 100 obserwujących, a zaangażowani odbiorcy 100 interakcji w danym okresie.
Z EasyCoexistence zrobisz to

Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.

Najczęściej zadawane pytania

Ile obserwujących potrzebuje konto na Instagramie do danych demograficznych?

100. Poniżej tego Meta nie zwraca follower_demographics; engaged_audience_demographics wymaga 100 interakcji w danym okresie.

Dlaczego Instagram zwraca tylko 45 miast?

Metryki demograficzne Meta zwracają tylko 45 najlepszych wyników, więc mniejsze miasta i kraje są pomijane.

Co zastąpiło audience_gender_age w API Instagrama?

follower_demographics, z podziałem na wiek, płeć, miasto lub kraj. Meta wycofała audience_gender_age, audience_locale, audience_country i audience_city 11 grudnia 2023.

Czy mogę użyć since i until z follower_demographics?

Nie. Metryki demograficzne nie obsługują since i until; zamiast tego parametr timeframe wyznacza zakres i jest wymagany.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w