AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

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.

100 followers

Darunter wird follower_demographics für das Konto nicht zurückgegeben.

100 engagements

Im Zeitraum benötigt, bevor engaged_audience_demographics zurückgegeben wird.

Top 45

Demografische Metriken liefern nur die 45 stärksten Werte, daher fallen kleinere Städte und Länder heraus.

19 Aug 2024

Ab wann last_14_days, last_30_days, last_90_days und prev_month bei engaged_audience_demographics in jeder Version nicht mehr funktionieren.

48 hours

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_type total_value, ein timeframe und eine Aufschlüsselung nach Alter, Stadt, Land oder Geschlecht.
  • audience_gender_age, audience_locale, audience_country und audience_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:

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>

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:

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

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_demographics wird für ein Konto mit weniger als 100 Followern nicht zurückgegeben.
  • engaged_audience_demographics wird 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.

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

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.
Mit EasyCoexistence

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