Facebook-Beitrags-Insights über die API: Aufrufe, Reichweite und Interaktionen
Facebook-Beitrags-Insights stammen von GET /{page-post-id}/insights mit Metriken wie post_media_view, wie oft der Beitrag abgespielt oder angezeigt wurde, post_total_media_view_unique, seinen eindeutigen Betrachtern, post_clicks und post_reactions_by_type_total. Meta hat post_impressions im November 2025 und post_impressions_unique im Juni 2026 abgekündigt, daher ersetzen Aufrufe und eindeutige Betrachter nun Impressionen und Reichweite.
easyCoexistence liest Facebook-Beitrags-Insights mit get_social_insights, sodass Claude, ChatGPT oder Ihr eigener Code fragen kann, wie erfolgreich ein Beitrag war, und Metas aktuelle Aufrufe, eindeutige Betrachter, Klicks und Reaktionen zurückbekommt; mit list_social_posts finden Sie den Beitrag.
Metas empfohlener Ersatz für post_impressions_unique, dessen Abkündigung für alle API-Versionen auf Juni 2026 gesetzt wurde.
Seit wann post_impressions in keiner Version mehr Daten liefert; Meta nennt post_media_view als Alternative.
Der Zeitraum, den Meta für Beitragsmetriken wie post_media_view, post_clicks und die Reaktionssummen angibt.
Was Metas Like-Reaktionszahlen enthalten: sowohl Like- als auch Care-Reaktionen.
Was Meta statt eines Fehlers zurückgibt, wenn der App die Berechtigung read_insights fehlt.
Welche Beitragsmetriken funktionieren 2026?
Diese stehen in Metas Insights-Referenz und sind laut den Abkündigungslisten Stand 1. November 2026 nicht betroffen. Jede wird über die ID des Beitrags gelesen, mit period lifetime, sofern nicht anders angegeben:
post_media_view: wie oft der Beitrag abgespielt oder angezeigt wurde, mit den Aufschlüsselungenis_from_adsundis_from_followers.post_total_media_view_unique: die eindeutigen Betrachter des Beitrags, Metas Ersatz für die Reichweite.post_clicks: Klicks irgendwo im Beitrag, die keine Story erzeugt haben;post_clicks_by_typeschlüsselt sie nach Konsumtyp auf.post_reactions_by_type_total: Reaktionen nach Typ, plus eine Summe pro Typ wiepost_reactions_love_totaloderpost_reactions_anger_total.post_video_views: Wiedergaben eines Videos von mindestens 3 Sekunden, mit period lifetime oder day.
Was hat Impressionen und Reichweite von Beiträgen ersetzt?
Meta hat die Beitragsmessung in zwei Schritten von Impressionen auf Medienaufrufe umgestellt, jeweils für alle API-Versionen gleichzeitig. Ein ausgemusterter Name liefert nun einen Fehler für ungültige Metrik zurück. Changelog, Liste der veralteten Metriken und die Hinweise zur Graph API v25 nennen diese Alternativen:
| Deprecated | Use instead | |
|---|---|---|
| Nov 15, 2025 | post_impressions | post_media_view |
| Nov 15, 2025 | post_impressions_paid | post_media_view with is_from_ads |
| Nov 15, 2025 | post_impressions_fan | post_media_view with is_from_followers |
| June 2026 | post_impressions_unique | post_total_media_view_unique |
| June 2026 | post_impressions_paid_unique, post_impressions_organic_unique | post_media_view breakdowns, which count views rather than people |
Worin unterscheiden sich Aufrufe und eindeutige Betrachter?
Aufrufe zählen Anzeigen, eindeutige Betrachter zählen Personen. post_media_view addiert jedes Mal, wenn der Beitrag abgespielt oder angezeigt wurde, sodass eine Person, die ihn zweimal sieht, zweimal zählt. post_total_media_view_unique zählt die eindeutigen Betrachter des Beitrags dagegen jeweils einmal. Meta kennzeichnet Metriken mit der Endung _unique als ungefähre Werte und berechnet eindeutige Werte unabhängig, daher muss eine Summe nicht der Summe ihrer Teile entsprechen.
Wie fordern Sie die Insights eines Beitrags an?
Mit GET /{page-post-id}/insights und metric als kommagetrennter Liste oder GET /{page-post-id}/insights/{metric} für eine einzelne Metrik. Das Token muss von jemandem stammen, der die Aufgabe ANALYZE auf der Seite ausführen kann, mit erteilten Berechtigungen read_insights und pages_read_engagement. Jedes Ergebnis enthält name, period, values, title und description. Metas eigenes Beispiel fragt die Reaktionssummen ab:
GET /{page-post-id}/insights?metric=post_reactions_like_total,post_reactions_love_total
{
"data": [
{
"name": "post_reactions_like_total",
"period": "lifetime",
"values": [{ "value": 226 }],
"title": "Lifetime Total Like Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
},
{
"name": "post_reactions_love_total",
"period": "lifetime",
"values": [{ "value": 17 }],
"title": "Lifetime Total Love Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
}
]
}Wie zählen Sie Reaktionen, Kommentare und Shares?
Aus den eigenen Feldern des Beitrags, neben seinen Insights. fields=reactions.summary(total_count) liefert die Gesamtzahl der Reaktionen und reactions.type(LOVE).limit(0).summary(total_count) die Anzahl eines Typs aus LIKE, LOVE, WOW, HAHA, SORRY und ANGRY. Das Feld shares enthält die Anzahl der Shares, die laut Meta auch gelöschte Beiträge und solche umfassen kann, die das Token nicht sehen kann. Die comments-Kante mit summary=true ergänzt ein total_count.
Wie hängen Beitragsmetriken mit Seitenmetriken zusammen?
Seitenmetriken addieren die Inhalte der Seite über einen Zeitraum, während Beitragsmetriken die Gesamtwerte eines einzelnen Beitrags über seine Laufzeit liefern. page_post_engagements zählt die Interaktion mit den Beiträgen der Seite durch Reaktionen, Kommentare, Shares und mehr, pro Tag, Woche oder days_28. page_media_view und page_total_media_view_unique tun dasselbe für Aufrufe und Betrachter. Meta hat post_engaged_users 2024 entfernt, daher wird die Interaktion pro Beitrag aus Klicks, Reaktionen, Kommentaren und Shares gebildet.
Wie aktuell sind die Daten, und wie weit reichen sie zurück?
Die meisten Metriken aktualisieren sich einmal täglich, die von Meta mit einem Sternchen markierten, wie post_clicks, mehrmals täglich. Meta bewahrt zwei Jahre Insights für öffentliche Seiten, aber nur 5 Tage für unveröffentlichte. lifetime bezeichnet den Zeitraum, für den Daten verfügbar sind, standardmäßig zwei Jahre oder weniger. Seiten-Insights setzen eine Seite mit 100 oder mehr Likes voraus, und mehrere Videometriken ergeben 0 bei einem Video, das erneut geteilt wurde, das von einer anderen Seite stammt.
Wie liest easyCoexistence Beitrags-Insights aus?
get_social_insights nimmt die Metriken entgegen und bei einem einzelnen Beitrag dessen object_id, die Beitrags-ID, die list_social_posts zurückgibt; ohne object_id liest es die Seite. period und zusätzliche Parameter wie since und until werden unverändert an Meta weitergegeben. Eine ausgemusterte Metrik kommt als Metas Fehler für ungültige Metrik zurück, sodass die KI auf einen aktuellen Namen wechseln kann.
Häufige Fehler
- post_impressions_unique abfragen. Meta hat es im Juni 2026 für alle API-Versionen abgekündigt; fragen Sie stattdessen post_total_media_view_unique ab, um eindeutige Betrachter zu zählen.
- Eindeutige Betrachter über Beiträge hinweg addieren. Jeder Beitrag zählt seine eigenen Betrachter, ungefähr, daher wird eine Person, die zwei Beiträge gesehen hat, doppelt gezählt.
- Insights eines Videos lesen, das von einer anderen Seite erneut geteilt wurde. Mehrere Videometriken liefern für erneut geteilte Videos 0; nur die Seite, die das Video erstellt hat, erhält genaue Werte.
- Einer Null aus einer leeren Antwort vertrauen. Ohne read_insights liefert Meta einen leeren Datensatz statt eines Fehlers; prüfen Sie daher zuerst die Berechtigung.
Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit den ersten 3 Tagen kostenlos.
Häufig gestellte Fragen
Was hat die Beitragsreichweite auf Facebook ersetzt?
post_total_media_view_unique, die Anzahl der eindeutigen Betrachter eines Beitrags, nachdem Meta post_impressions_unique im Juni 2026 abgekündigt hat.
Kann ich sehen, wer auf einen Seitenbeitrag reagiert hat?
Nein. Meta liefert Reaktionszahlen nach Typ, aber eine Seite oder Person kann nur die eigene Reaktion abfragen; die anderen bleiben privat.
Enthalten Like-Zählungen Care-Reaktionen?
Ja. Metas Like-Summen zählen sowohl Like- als auch Care-Reaktionen, in den Insights wie auf der reactions-Kante.
Kann ich Insights für einen Beitrag auf einer anderen Seite lesen?
Nicht über Seiten-Insights. Dafür braucht es ein Token von jemandem, der die Aufgabe ANALYZE auf der Seite ausführen kann, die den Beitrag erstellt hat.
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