Zum Hauptinhalt springen
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.

Header-Parameter

Body-Parameter

id
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.
platforms
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.