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.
Poniżej tego progu follower_demographics nie jest zwracane dla konta.
Tyle interakcji w danym okresie jest potrzebne, zanim zwrócone zostanie engaged_audience_demographics.
Metryki demograficzne zwracają tylko 45 najwyższych wyników, więc mniejsze miasta i kraje znikają z zestawienia.
Kiedy last_14_days, last_30_days, last_90_days i prev_month przestały działać dla engaged_audience_demographics we wszystkich wersjach.
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_typetotal_value, timeframe oraz podział na wiek, miasto, kraj lub płeć. audience_gender_age,audience_locale,audience_countryiaudience_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:
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:
{
"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_demographicsnie jest zwracane dla konta z mniej niż 100 obserwującymi.engaged_audience_demographicsnie 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.
{
"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.
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