Facebook API Fehler: „OAuthException: (#100) The value must be a valid insights metric"

Bekommst Du beim Abrufen Deiner Facebook- oder Meta-Insights plötzlich die Fehlermeldung:

OAuthException: (#100) The value must be a valid insights metric 

und verwendest dabei die Kennzahlen post_impressions oder post_impressions_unique? Dann liegt das nicht an einem Fehler in Deinem Code oder an fehlenden Berechtigungen. Meta hat diese Kennzahlen im Rahmen einer Überarbeitung der Facebook Pages Insights API eingestellt.

Quickfix: Ersetze post_impressions oder post_impressions_unique durch post_total_media_view_unique

Seit den API-Änderungen im Jahr 2025 werden zahlreiche Reichweiten- und Impression-Metriken nicht mehr unterstützt. Anwendungen, WordPress-Plugins, CRM-Systeme und individuelle Integrationen müssen deshalb auf die neuen Kennzahlen umgestellt werden.

In diesem Beitrag erfährst Du:

• warum der Fehler auftritt,

• welche Kennzahlen eingestellt wurden,

• welche Alternativen Meta empfiehlt und

• wie Du Deine API-Abfragen anpassen kannst.

Warum erscheint der Fehler „The value must be a valid insights metric“?

Die Fehlermeldung

OAuthException: (#100) The value must be a valid insights metric

tritt auf, wenn Deine API-Abfrage eine Kennzahl verwendet, die von Meta nicht mehr unterstützt wird.

Besonders häufig betroffen sind die folgenden Metriken:

post_impressions
post_impressions_unique

Diese Kennzahlen wurden von Meta entfernt und liefern seit der Einstellung keine Daten mehr.

Änderungen zum 15. Juni 2025

Am 15. Juni 2025 wurden zahlreiche Reichweiten- und Impression-Kennzahlen endgültig entfernt. Die API liefert bei deren Verwendung lediglich eine oAuth Exception zurück.

Entfernte Seiten-Metriken

• page_impressions_unique

• page_impressions_paid_unique

• page_impressions_viral_unique

• page_impressions_nonviral_unique

Neue Alternative:

page_total_media_view_unique

Entfernte Beitrags-Metriken

• page_posts_impressions

• page_posts_impressions_unique

• page_posts_impressions_paid

• page_posts_impressions_paid_unique

• page_posts_impressions_organic_unique

• page_posts_served_impressions_organic_unique

• page_posts_impressions_viral

• page_posts_impressions_viral_unique

• page_posts_impressions_nonviral

• page_posts_impressions_nonviral_unique

Entfernte Post-Metriken

• post_impressions_unique

• post_impressions_paid_unique

• post_impressions_fan_unique

• post_impressions_organic_unique

• post_impressions_viral_unique

• post_impressions_nonviral_unique

Neue Alternative:

post_total_media_view_unique

Änderungen zum 15. November 2025

Die zweite große Bereinigung erfolgte am 15. November 2025. Besonders betroffen sind Fan- und Impression-Kennzahlen.

Fans werden zu Follows

Meta ersetzt den Begriff Fans zunehmend durch Follows.

` `

` `

` `

Seiten-Impressions werden durch Media Views ersetzt

` `

``

### Post-Impressions werden ersetzt

| Veraltete Kennzahl | Neue Lösung |
|---|---|
| post_impressions | post_media_view |
| post_impressions_paid | post_media_view mit is_from_ads-Breakdown |
| post_impressions_fan | post_media_view mit is_from_followers-Breakdown |
| post_impressions_organic | post_media_view mit is_from_ads-Breakdown |

``
``

``

``

``

Was bedeutet das für Dich?

Wenn Deine Anwendung, Dein Dashboard oder Dein Reporting-System noch auf die alten Metriken zugreift, solltest Du zeitnah handeln.

• Eigene API-Abfragen prüfen

• Automatisierte Reportings kontrollieren

• BI-Tools und Dashboards aktualisieren

• WordPress-Plugins überprüfen

• CRM- und ERP-Integrationen anpassen

• Individuell entwickelte Schnittstellen aktualisieren

So behebst Du den Fehler

Wenn Du bisher Folgendes verwendet hast:

metric=post_impressions

oder

metric=post_impressions_unique

musst Du Deine Anwendung auf die neuen Kennzahlen umstellen.

Beispiel

Alt:

metric=post_impressions

Neu:

metric=post_media_view

Alt:

metric=post_impressions_unique

Neu:

metric=post_total_media_view_unique

Fazit

Der Fehler

OAuthException: (#100) The value must be a valid insights metric

bei post_impressions oder post_impressions_unique ist die direkte Folge der Änderungen an der Facebook Pages Insights API.

Meta hat zahlreiche Impression-Kennzahlen eingestellt und durch neue Media-View-Metriken ersetzt. Wenn Du die alten Kennzahlen weiterhin verwendest, erhältst Du zwangsläufig einen API-Fehler.

Überprüfe deshalb Deine API-Abfragen und stelle sie auf die neuen Metriken um, damit Deine Facebook-Integrationen, Dashboards und Reportings weiterhin zuverlässig funktionieren.

Quellen

• https://developers.facebook.com/documentation/pages-api/platforminsights/page/deprecated-metrics