Instagram-Follower-Demografie über die API
Der Endpoint für Konto-Insights von Instagram liefert Follower-Demografien mit metric=follower_demographics, period=lifetime, metric_type=total_value, einem timeframe und einer Aufschlüsselung nach Alter, Geschlecht, Stadt oder Land. engaged_audience_demographics liefert dasselbe für Konten, die mit den Inhalten interagiert haben. Meta gibt nur die 45 häufigsten Werte zurück. Follower-Daten brauchen 100 Follower, engagierte Daten 100 Interaktionen im Zeitraum.
easyCoexistence liest die Demografien der Follower und der engagierten Zielgruppe von Instagram mit get_social_insights.
Darunter wird follower_demographics für das Konto nicht zurückgegeben.
Im Zeitraum benötigt, bevor engaged_audience_demographics zurückgegeben wird.
Demografische Metriken liefern nur die 45 stärksten Werte, daher fallen kleinere Städte und Länder heraus.
Ab wann last_14_days, last_30_days, last_90_days und prev_month bei engaged_audience_demographics in jeder Version nicht mehr funktionieren.
Wie lange die Daten hinter Konto-Metriken verzögert sein können.
Welche demografischen Metriken gibt es?
Zwei in Metas Referenz zu Konto-Insights, beide gelesen mit GET /<IG_ID>/insights, und zwei ältere Sets, die alter Code noch anfragt:
follower_demographics: die demografischen Merkmale der Follower des Kontos.engaged_audience_demographics: dasselbe für die engagierte Zielgruppe, also die Konten, die mit seinen Inhalten interagiert haben.- Beide: period lifetime,
metric_typetotal_value, ein timeframe und eine Aufschlüsselung nach Alter, Stadt, Land oder Geschlecht. audience_gender_age,audience_locale,audience_countryundaudience_city: am 11. Dezember 2023 eingestellt.reached_audience_demographics: im Changelog von Meta 2024 genannt, fehlt aber in der aktuellen Metriktabelle.
Wie fragt man demografische Daten der Follower ab?
Mit der Metrik, period=lifetime, metric_type=total_value, einem timeframe und einer Aufschlüsselung. timeframe ersetzt since und until, die demografische Metriken nicht unterstützen, und ist Pflicht. Mit Instagram Login braucht das Token instagram_business_basic und instagram_business_manage_insights, und der Aufruf geht an 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>Wie sieht die Antwort aus?
Die Zählwerte stehen in total_value.breakdowns. dimension_keys benennt den angefragten Zeitraum und die Aufschlüsselung, und jedes Ergebnis verknüpft dimension_values, den Zeitraum und einen Wert der Aufschlüsselung mit einem Zählwert. Metas Beispiel für die engagierte Zielgruppe nach Land gibt Länder als zweistellige Codes wie US und ES zurück:
{
"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"
}
]
}Welche Zeiträume funktionieren?
Metas Referenz listet last_14_days, last_30_days, last_90_days, prev_month, this_month und this_week für beide Metriken auf. Bei der engagierten Zielgruppe beschreibt sie this_month als die letzten 30 Tage und this_week als die letzten 7. Bei engaged_audience_demographics haben die ersten vier ab v20.0 und in jeder Version am 19. August 2024 aufgehört zu funktionieren. Deshalb this_week oder this_month verwenden. Dieser Changelog-Eintrag nennt follower_demographics nicht.
Welche Schwellen und Grenzen gelten?
Metas Referenz zu Konto-Insights legt für demografische Metriken diese Regeln fest:
follower_demographicswird für ein Konto mit weniger als 100 Followern nicht zurückgegeben.engaged_audience_demographicswird mit weniger als 100 Interaktionen im Zeitraum nicht zurückgegeben.- Nur die 45 stärksten Werte kommen zurück, daher fallen kleinere Städte und Länder heraus.
- Nur Zuschauer mit demografischen Daten werden gezählt, daher können die Werte in Summe weniger als die Follower-Zahl ergeben.
- Fehlende Daten liefern eine leere Menge statt 0, und Daten können bis zu 48 Stunden verzögert sein.
- Eine Aufschlüsselung, die eine angefragte Metrik nicht unterstützt, lässt den ganzen Aufruf mit der Meldung An unknown error has occurred. scheitern.
Funktionieren Demografien mit Instagram Login?
Ja. Meta hat Konto- und Medien-Insights am 21. Januar 2025 für Apps mit Instagram Login geöffnet. Metas Referenz zu Konto-Insights nennt Instagram Login mit den Berechtigungen instagram_business_basic und instagram_business_manage_insights sowie graph.instagram.com als Host. Das Konto muss ein Unternehmenskonto oder ein Creator-Konto sein, wie Metas Instagram Platform verlangt.
Wie liest get_social_insights demografische Daten?
Mit metrics auf follower_demographics oder engaged_audience_demographics, period auf lifetime und params mit timeframe, breakdown und metric_type. easyCoexistence ruft GET /<IG_ID>/insights für das verbundene Konto mit seinem Token auf und gibt Metas Antwort zurück, damit Claude oder ChatGPT sagen kann, welche Länder, Städte oder Altersgruppen dem Konto folgen.
{
"account_id": "<ACCOUNT_ID>",
"metrics": ["follower_demographics"],
"period": "lifetime",
"params": {
"timeframe": "this_month",
"breakdown": "age",
"metric_type": "total_value"
}
}Häufige Fehler
- since und until übergeben. Demografische Metriken unterstützen sie nicht: timeframe legt den Zeitraum fest, und er ist Pflicht.
- last_30_days oder last_90_days für die engagierte Zielgruppe verwenden. Diese Zeiträume funktionieren bei engaged_audience_demographics seit dem 19. August 2024 in keiner Version mehr.
- Eine Aufschlüsselung summieren, um die Follower-Zahl zu erhalten. Nur Zuschauer mit demografischen Daten werden gezählt und nur die 45 stärksten Werte kommen zurück, daher fällt die Summe zu niedrig aus.
- Daten von einem kleinen Konto erwarten. Follower-Demografien brauchen 100 Follower, die engagierte Zielgruppe 100 Interaktionen im Zeitraum.
So können Claude, ChatGPT oder Ihr eigener Code fragen, welche Länder, Städte oder Altersgruppen dem Konto folgen, und erhalten Metas Zahlen für das verbundene Konto. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, die ersten 3 Tage kostenlos.
Häufig gestellte Fragen
Wie viele Follower braucht ein Instagram-Konto für Demografien?
100. Darunter gibt Meta follower_demographics nicht zurück; engaged_audience_demographics braucht 100 Interaktionen im Zeitraum.
Warum liefert Instagram nur 45 Städte zurück?
Metas demografische Metriken liefern nur die 45 stärksten Werte, daher fallen kleinere Städte und Länder weg.
Was hat audience_gender_age in der Instagram API ersetzt?
follower_demographics, mit einer Aufschlüsselung nach Alter, Geschlecht, Stadt oder Land. Meta hat audience_gender_age, audience_locale, audience_country und audience_city am 11. Dezember 2023 eingestellt.
Kann ich since und until mit follower_demographics verwenden?
Nein. Demografische Metriken unterstützen since und until nicht; stattdessen legt der Parameter timeframe den Zeitraum fest, und er ist Pflicht.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am