Statistiken eines Betriebs abrufen

Liefert die jüngsten gültigen Zahlen, die Sofia für jedes verbundene Konto gesammelt hat. Ein noch nicht erfasstes Konto zeigt awaiting, nie null.

GEThttps://api.sofia-post.com/api/v1/establishments/{id}/insights

GET/v1/establishments/{id}/insights

API-Schlüssel oder Access-TokenNur in diesem Tab gespeichert und nur an api.sofia-post.com gesendet.id (path)period (query)

curl -X GET 'https://api.sofia-post.com/api/v1/establishments/{id}/insights' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Autorisierungen

Authorizationstringerforderlich
Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Pfadparameter

idstringerforderlich
Kennung des Betriebs.

Abfrageparameter

periodstring
Der Zeitraum; ohne Angabe die letzten 28 Tage.
Zulässige Werte: last24Hourslast7Dayslast28Days

Antwort

200application/json

Die Zahlen jedes verbundenen Kontos.

establishmentIdstringerforderlich
Kennung des Betriebs.
periodstringerforderlich
Von den Zahlen abgedeckter Zeitraum
Zulässige Werte: last24Hourslast7Dayslast28Days
dataobject[]erforderlich
Die Zahlen jedes verbundenen Kontos
Untergeordnete Attribute anzeigen
- platformstringerforderlich
  Plattformkennung des Netzwerks
- viewsobjecterforderlich
  Wie oft der Inhalt angezeigt oder abgespielt wurde. Instagram nennt das views; dasselbe Konto kann mehrfach zählen, es ist daher nie mit der Reichweite austauschbar.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- reachobjecterforderlich
  Eindeutige Konten, die den Inhalt im Zeitraum mindestens einmal gesehen haben.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- reachDeltaPercentobjecterforderlich
  Änderung der Reichweite gegenüber dem Vorzeitraum, in vorzeichenbehafteten Prozent.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- accountsEngagedobjecterforderlich
  Eindeutige Konten, die mit dem Inhalt interagiert haben.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- totalInteractionsobjecterforderlich
  Likes, Kommentare, Speicherungen, Shares und weitere unterstützte Interaktionen.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- likesobjecterforderlich
  Likes im Zeitraum.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- commentsobjecterforderlich
  Kommentare im Zeitraum.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- sharesobjecterforderlich
  Shares im Zeitraum.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- savesobjecterforderlich
  Speicherungen im Zeitraum.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- engagementRatePercentobjecterforderlich
  Interaktionen insgesamt geteilt durch erreichte Konten, in Prozent. Von Sofia berechnet, keine Zahl der Plattform. Nicht verfügbar, wenn die Reichweite fehlt oder null ist.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- engagementDeltaPointsobjecterforderlich
  Änderung der Engagement-Rate gegenüber dem Vorzeitraum, in Punkten.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- followersDeltaobjecterforderlich
  Netto-Änderung der Follower im Zeitraum. Meta hält sie für Instagram-Konten unter 100 Followern zurück, gemeldet als below-follower-threshold, weder als Fehler noch als 0.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- postsPublishedDuringPeriodobjecterforderlich
  Im Zeitraum veröffentlichte Beiträge.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- followersTotalobjecterforderlich
  Absolute Follower-Zahl des verbundenen Profils. Bei Instagram stammt sie aus instagram_business_basic, nicht aus Insights. available mit Wert 0 heißt, die Plattform meldete null; ein Fehlen ist unavailable mit Grund, beides ist nie dieselbe Zahl.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- postsTotalobjecterforderlich
  Absolute Zahl der Beiträge im Netzwerk, seit jeher, gemeldet vom verbundenen Profil. Derselbe Vertrag wie followersTotal: Eine gemeldete Null bleibt null, ein Fehlen bleibt fehlend.
  Untergeordnete Attribute anzeigen
  - statusstringerforderlich
    Ob die Plattform diese Metrik tatsächlich geliefert hat. available kann den Wert 0 tragen, eine gemessene Null. unavailable trägt nie einen Wert.
    Zulässige Werte: availableunavailable
  - valuenumber
    Die gemessene Zahl. Nur vorhanden, wenn der Status available ist; 0 ist ein echter Wert.
  - reasonstring
    Warum die Metrik fehlt. below-follower-threshold: Meta hält Zielgruppenmetriken unter 100 Followern zurück, das ist kein Fehler. permission-denied: Dem verbundenen Konto fehlt eine Insights-Berechtigung, dauerhaft bis zur erneuten Verbindung durch den Inhaber, nie vorübergehend. not-collected: Sofia misst diese Zahl an diesem Endpoint noch nicht, die Plattform wurde nie gefragt und trifft keine Schuld.
    Zulässige Werte: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Wahr, solange die Plattform dieses Fenster noch auffüllen kann; Instagram liefert manche Zahlen bis zu 48 Stunden verspätet.
  - sourceMetricstring
    Das Plattformfeld, aus dem diese Zahl stammt, full_video_watched_rate bei TikTok, post_video_view_time bei Facebook. Zwei Netzwerke nennen Verschiedenes „Abschluss“; ohne dieses Feld würde ein Bericht sie nebeneinander stellen, als wären sie vergleichbar.
  - granularitystring
    Was die Zahl abdeckt: eine Gesamtsumme seit Beginn, eine Stunde, ein Tag, der ganze angefragte Zeitraum, wie das Netzwerk ihn aggregiert hat, oder eine Videosekunde. Tagesreihe, Zeitraumaggregat und Gesamtsumme sind nicht dieselbe Messung: nicht auf derselben Achse darstellen, nicht addieren.
    Zulässige Werte: lifetimehourdayperiodvideo-second
- hasInsightsDatabooleanerforderlich
  Wahr, wenn mindestens ein Insights-Aufruf erfolgreich war. Follower und Beitragszahlen kommen auch aus dem Basisprofil, ihr Vorhandensein beweist daher nicht, dass Insights lesbar sind.
- mayBeDelayedbooleanerforderlich
  Wahr, solange die Plattform dieses Fenster noch auffüllen kann (bis zu 48 Stunden).
- socialAccountIdstringerforderlich
  Das verbundene Konto, zu dem diese Zahlen gehören.
- collectionobjecterforderlich
  Die Erfassungsdaten hinter diesen Zahlen.
  Untergeordnete Attribute anzeigen
  - statestringerforderlich
    awaiting-first-collection: Das Konto ist verbunden und es gibt noch keine gültige Antwort, jede Metrik lautet not-collected.
    Zulässige Werte: collectedawaiting-first-collection
  - isOutdatedbooleanerforderlich
    Wahr, wenn ein späterer Versuch scheiterte oder die nächste Erfassung über eine Stunde überfällig ist. Die Zahlen bleiben für ihr Fenster und Datum gültig, sie sind nicht aktuell.
  - isCollectingbooleanerforderlich
    Wahr, solange eine Erfassung dieses Kontos läuft.
  - collectedAtnumber
    Wann das Netzwerk geantwortet hat (Unix ms).
  - windowStartnumber
    Beginn des beim Netzwerk angefragten Fensters (Unix ms).
  - windowEndnumber
    Ende des beim Netzwerk angefragten Fensters (Unix ms).
  - completenessstring
    partial: Das Netzwerk hat nur einen Teil des Fensters beantwortet oder einige Metriken sind fehlgeschlagen.
    Zulässige Werte: completepartial
  - nextCollectionAtnumber
    Wann die nächste Erfassung fällig ist (Unix ms).
  - lastFailedAttemptobject
    Der letzte Versuch, wenn er nach den angezeigten Zahlen endete und nicht erfolgreich war.
    Untergeordnete Attribute anzeigen
    atnumbererforderlich
    Wann der Versuch endete (Unix ms)
    outcomestringerforderlich
    deferred: Das Netzwerk hat Sofia um Wartezeit gebeten (Ratenlimit, Kontingent). failed: alles andere.
    Zulässige Werte: faileddeferred
    reasonstring
    Warum, wie Sofia es eingestuft hat (reauthentication-required, platform-error…).
- reachDailySeriesnumber[]
  Tägliche Reichweitenwerte. Fehlt, wenn die Plattform keine Reihe geliefert hat, nie mit Nullen aufgefüllt.
- engagementDailySeriesnumber[]
  Tägliche Engagement-Rate in Prozent. Fehlt bei Instagram: total_interactions hat keinen Zeitreihenmodus, daher gibt es keine ehrliche Tagesrate.
- followersDailySeriesnumber[]
  Tägliche Netto-Änderung der Follower. Fehlt, wenn die Plattform sie nicht meldet.
- fetchedAtnumber
  Wann das Netzwerk geantwortet hat (Unix ms). Fehlt bis zur ersten erfolgreichen Erfassung.

401

Das Token fehlt, ist unbekannt, abgelaufen oder widerrufen.

403

Dem Token fehlt die Berechtigung insights:read.

404

Betrieb außerhalb des Workspace des Tokens.

4XXapplication/json

Jeder andere Fehler, im Fehlerumschlag.

Statistiken eines Betriebs abrufen

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/establishments/<id>/insights' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "establishmentId": "string",
  "period": "last24Hours",
  "data": [
    {
      "platform": "instagram",
      "views": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reach": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reachDeltaPercent": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "accountsEngaged": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "totalInteractions": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "likes": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "comments": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "shares": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "saves": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "engagementRatePercent": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "engagementDeltaPoints": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "followersDelta": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "postsPublishedDuringPeriod": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reachDailySeries": [
        0
      ],
      "followersDailySeries": [
        0
      ],
      "followersTotal": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "postsTotal": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "hasInsightsData": true,
      "mayBeDelayed": false,
      "fetchedAt": 1739539200000,
      "socialAccountId": "acc_123",
      "collection": {
        "state": "collected",
        "collectedAt": 1739539200000,
        "completeness": "complete",
        "isOutdated": false,
        "isCollecting": false
      }
    }
  ]
}