Skip to main content
POST
Rufen Sie Analytics in Echtzeit ab, etwa Likes, Impressionen, Aufrufe und Reaktionen für einen Beitrag, der über Ayrshare gesendet wurde, unter Verwendung der Ayrshare-Post-ID. Für Analytics zu Beiträgen, die außerhalb von Ayrshare erstellt wurden, siehe Analytics anhand der Social Post ID.
Facebook: Einige Reach- und Video-Kennzahlen wurden von Meta eingestellt (15. Juni 2026). Meta hat die Insights-Kennzahlen für Unique Impressions und 3-Sekunden-Videoaufrufe in allen Graph-API-Versionen entfernt. Das Facebook-analytics-Objekt liefert daher impressionsUnique, impressionsFanUnique, impressionsOrganicUnique, impressionsPaidUnique und videoViewsUnique nicht mehr zurück. Verwenden Sie mediaView für Reach (ein Nachfolger für Total Unique Media Views ist geplant). Andere häufig genutzte Felder wie reactionsByType und videoViews sind nicht betroffen. Referenz: Upcoming API Changes — June 15, 2026.

Weitere Informationen

  • Die folgenden Plattformen werden derzeit unterstützt: Bluesky, Facebook Pages, Instagram, X/Twitter, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok und YouTube.
  • Die in der API angezeigten Kommentaranzahlen für Facebook und Instagram können von den in den Social-Apps angezeigten Werten abweichen. Das hat zwei Gründe: - Manche Nutzer haben Datenschutzeinstellungen, die ihre Kommentare vor Nicht-Freunden oder Nutzern ohne gegenseitige Verbindung verbergen. Diese privaten Kommentare fließen dennoch in die Gesamtanzahl ein. - Es kann Inkonsistenzen in den von Meta gemeldeten Daten geben.
  • Instagrams igReelsAggregatedAllPlaysCount und playsCount können in der API von den in den Social-Apps angezeigten Werten abweichen. Das kann mehrere Gründe haben:
    • Der Beitrag wurde beworben. Nur organische Plays werden in der API-Antwort berücksichtigt.
    • Es kann Inkonsistenzen in den von Meta gemeldeten Daten geben.
  • X/Twitter-Threads werden als Array von Objekten zurückgegeben, wobei jedes Objekt einem Tweet im Thread entspricht.
  • YouTube kann 24–48 Stunden benötigen, um Analytics für Videos mit wenigen Videoaufrufen oder wenigen Kanal-Followern zu verarbeiten.
  • TikTok Analytics:
    • TikTok kann 24–48 Stunden benötigen, um seine Analytics-Daten zu aktualisieren, etwa Videoaufrufe, Demografie, Likes, Shares und Kommentare.
    • Für den Zugriff auf TikTok-Analytics müssen Kontoinhaber: 1. Mindestens ein Video veröffentlichen. 2. In der TikTok-Mobile-App auf der Analytics-Seite auf die Schaltfläche „Turn On” tippen. 3. 100 Follower haben, um zusätzliche Einblicke zu Zuschauern und Content-Engagement zu erhalten.
    • TikTok gibt keine Post-Analytics zurück, wenn das Medium urheberrechtlich geschütztes Material enthält oder wegen einer Urheberrechtsverletzung markiert wurde. Beispiele für urheberrechtlich geschütztes Material sind Audiospuren in Reels (TikTok schaltet diese Videos stumm). Sie können dies in der TikTok-App unter „Activity” → „System Notifications” prüfen.
    • Einige TikTok-Analytics-Felder sind möglicherweise nicht verfügbar, wenn das Video länger als 7 Tage inaktiv war. Um diese Daten abzurufen, erzeugen Sie neue Aktivität für das Video (View, Like, Kommentar oder Share) und versuchen Sie es nach 24–48 Stunden erneut. Wenn ein Video nicht in der Antwort zurückgegeben wird, liegt der Grund wahrscheinlich darin, dass das Video aufgrund von Verstößen (z. B. Urheberrechtsverletzung bei der Musik) herausgefiltert wurde. Zu diesen Feldern gehören:
      • reach
      • fullVideoWatchedRate
      • totalTimeWatched
      • averageTimeWatched
      • impressionSources
      • audienceCountries
  • Persönliche (Member-)LinkedIn-Profile liefern jetzt eine erweiterte Post-Analytics-Matrix. Die verfügbaren Member-Kennzahlen sind:
    • impressionCount — Impressionen des Beitrags
    • uniqueImpressionsCount — Erreichte Unique Members (LinkedIn MEMBERS_REACHED)
    • likeCount — Anzahl der Reaktionen
    • commentCount — Anzahl der Kommentare
    • shareCount — Reshares des Beitrags
    • engagement — Organische Klicks, Likes, Kommentare und Shares im Verhältnis zu Impressionen
    • reactions — Aufschlüsselung nach Reaktionstyp (sofern Reaktionen vorhanden sind)
    • Für Videobeiträge: videoViews, videoViewers und videoWatchTimeMs
    Video-Kennzahlen werden nur für Videobeiträge zurückgegeben und sind mehr als ein Jahr nach der Erstellung des Beitrags nicht mehr verfügbar.
  • Insights zu Instagram Stories sind nur für 24 Stunden verfügbar, unabhängig davon, ob die Stories archiviert oder als Highlight gespeichert wurden. Hinweis:
    • Story-Medienkennzahlen mit Werten unter 5 werden als 0 zurückgegeben.
    • Für Stories, die von Nutzern in Europa und Japan erstellt wurden, gibt die Kennzahl replies den Wert 0 zurück.
  • Facebook-Story-Analytics sind nicht verfügbar.
  • Pinterest-Analytics-Daten (Impressionen, Follower des Nutzers und Klicks) werden nach 24–72 Stunden verfügbar.
  • Bei YouTube Shorts entspricht views der Häufigkeit, mit der ein Short gestartet oder wiedergegeben wird, ohne dass eine Mindestwiedergabezeit erforderlich ist.

Multiplattform-Reads & Teilerfolg

Eine einzelne Ayrshare Post ID kann mehrere Plattformen umfassen. Ayrshare fächert eine Anfrage in einen Zweig („leg”) pro Plattform auf und gibt einen Teilerfolg zurück, wenn einige Zweige erfolgreich sind und andere fehlschlagen – die Analytics der intakten Plattformen werden stets zurückgegeben, und jeder fehlgeschlagene Zweig wird in einem obersten errors[]-Array aufgeführt.
  • Einige Plattformen erfolgreich, einige fehlgeschlagen: Die Antwort ist HTTP 200 mit status: “partial”. Die intakten analytics-Blöcke pro Plattform werden wie gewohnt zurückgegeben, und ein oberstes errors[]-Array listet jeden fehlgeschlagenen Zweig mit seiner platform, seinem status, code, seiner message und seiner id auf.
  • Alle Plattformen fehlgeschlagen: Die Antwort hat status: “error” und das vollständige errors[]-Array. Der HTTP-Status wird vom repräsentativen Fehlercode auf oberster Ebene abgeleitet. Code 485 wird auf HTTP 404 abgebildet; andere repräsentative Codes verwenden ihre eigenen Zuordnungen.
  • Alle Plattformen erfolgreich: Die Antwort ist unverändert – HTTP 200, status: “success” und kein errors[]-Schlüssel.
Verhaltensänderung – prüfen Sie errors[], verzweigen Sie nicht anhand des HTTP-Status. Da ein plattformübergreifender Read mit einem fehlgeschlagenen Zweig nun HTTP 200 zurückgibt, anstatt die gesamte Antwort auf einen Fehler zu reduzieren, sollten Integratoren stets prüfen, ob ein oberstes errors[]-Array vorhanden ist, um Fehler auf Plattformebene zu erkennen, statt sich allein auf den HTTP-Statuscode zu verlassen.

Abgelaufene oder nicht verfügbare Instagram-Story-Analytics

Ein Instagram-Story-Analytics-Zweig, der abgelaufen oder nicht verfügbar ist – sodass seine Insights nicht abgerufen werden können – erscheint in errors[] mit Code 485. Eine repräsentative Meldung lautet “Instagram Story expired or unavailable — comments/insights cannot be retrieved.” Facebook-Story-Analytics bleiben nicht verfügbar und sind von diesem Verhalten nicht erfasst. Wenn eine andere Plattform erfolgreich ist, werden deren Analytics dennoch zurückgegeben und die Gesamtantwort ist HTTP 200. Bei einer Antwort mit vollständigem Fehlschlag wird der repräsentative Code 485 auf HTTP 404 abgebildet; andere repräsentative Codes verwenden ihre eigenen Zuordnungen. Gleichen Sie den code (485) ab, nicht den exakten Meldungstext. (Siehe auch den Hinweis oben: Instagram-Story-Insights sind nur 24 Stunden lang verfügbar.)

Beispiel: Teilerfolgs-Antwort

200: Teilerfolg

Header-Parameter

Body-Parameter

string
erforderlich
Ayrshare-Post-ID, die vom /post-Endpunkt zurückgegeben wird. Das ist die auf oberster Ebene zurückgegebene Ayrshare-id und nicht die Social-Post-IDs in postIds.
array
String-Array der Plattformen, für die Analytics abgerufen werden sollen. Akzeptiert ein Array von Strings mit den folgenden Werten:
Wenn platforms nicht angegeben wird, werden Analytics für alle sozialen Netzwerke zurückgegeben, an die der Beitrag gesendet wurde.
Wenn kumulative Kennzahlen (z. B. Likes, Kommentare, Aufrufe) vom sozialen Netzwerk vorübergehend nicht verfügbar sind, füllt die API sie automatisch aus gespeicherten Daten auf. Im plattformspezifischen analytics-Objekt können zwei optionale Felder erscheinen:
  • backfilledFrom (String, ISO 8601) — Vorhanden, wenn eine oder mehrere kumulative Kennzahlen aus gespeicherten Daten ersetzt wurden. Der Zeitstempel gibt an, wann die gespeicherten Daten zuletzt aktualisiert wurden.
  • recoveredFrom (String, ISO 8601) — Vorhanden, wenn die gesamte Analytics-Antwort aufgrund eines vollständigen API-Ausfalls aus gespeicherten Daten wiederhergestellt wurde. Der Zeitstempel gibt an, wann die gespeicherten Daten zuletzt aktualisiert wurden.
Gespeicherte Daten, die älter als 4 Tage sind, gelten als veraltet und werden nicht für Backfill oder Wiederherstellung verwendet.
LinkedIn-Personal (Member) Analytics – erneute Verknüpfung erforderlich. Persönliche LinkedIn-Profile, die vor der Einführung der Post-Analytics für Member verknüpft wurden, verfügen nicht über die erforderlichen Analytics-Scopes. Analytics-Anfragen für diese Profile liefern Fehlercode 475 zurück („Verknüpfen Sie Ihr LinkedIn-Profil erneut, um Analytics zu aktivieren”). Der Kontoinhaber muss sein LinkedIn-Profil auf der Seite Social Accounts erneut verknüpfen, um die neuen Scopes zu gewähren. Rechnen Sie nach der erneuten Verknüpfung mit einigen Minuten, bis Code 475 verschwindet (Ayrshare und LinkedIn cachen den Berechtigungsstatus jeweils kurz, in der Regel ca. 5–10 Minuten). Das Posten ist nicht betroffen.Die Anzahlwerte für LinkedIn-Member-Beiträge sind Best-Effort: Die aggregierten Summen shareCount (RESHARE), likeCount (REACTION) und commentCount (COMMENT) können geringfügig von den in der LinkedIn-UI angezeigten Zahlen abweichen.