Zum Hauptinhalt springen
POST
Erhalten Sie Analytics und demografische Daten zum Social-Profil eines Nutzers, etwa Impressionen, Aufrufe und Follower. Derzeit verfügbar für Bluesky, Facebook Pages, Google My Business, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok, X/Twitter und YouTube.
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 (Unique) in allen Graph-API-Versionen entfernt. Das Facebook-analytics-Objekt liefert daher weder die Familie pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*, pagePostsServedImpressionsOrganicUnique) noch pageVideoViewsUnique zurück. Verwenden Sie pageMediaView für Reach (ein Nachfolger für Total Unique Media Views ist geplant). pagePostEngagements, pageVideoViews und pageVideoViewsPaid sind nicht betroffen. Referenz: Upcoming API Changes — June 15, 2026.
  • Analytics für Facebook-Seiten (etwa Demografie) sind nur für Seiten mit 100 oder mehr Likes verfügbar. Facebook aktualisiert seine Kennzahlen in der Regel alle 24 Stunden.
  • Instagram kann bis zu 48 Stunden benötigen, um die Analytics-Daten zu berechnen. Analytics zur Follower-Anzahl sind bei weniger als 100 Followern nicht verfügbar. Bei demografischen Kennzahlen werden nur die Top 45 zurückgegeben; in die Berechnungen fließen ausschließlich Betrachter ein, für die uns demografische Daten vorliegen. Demografische Daten werden nicht zurückgegeben, wenn der Instagram-Nutzer in den letzten 30 Tagen weniger als 100 Engagements hatte.
  • Beim Abruf von Instagram Social Analytics können demografische Informationen für bestimmte Kennzahlen in der Antwort fehlen. Demografische Informationen erscheinen, sobald die Kennzahlen in jeder Aufschlüsselung mehr als 100 Personen umfassen. Weitere Informationen finden Sie unter Instagram Analytics Demographics Warning.
  • LinkedIn unterstützt sowohl Analytics für Company Pages als auch für persönliche (Member-)Profile. Für persönliche Profile enthält das analytics-Objekt einen followersCount (Lifetime), das tägliche Follower-Wachstum in followersDaily[] sowie aggregierte Post-Kennzahlen (impressionCount, uniqueImpressionsCount, likeCount, commentCount, shareCount). Die count-Summen von LinkedIn sind eventuell konsistent, aber nicht unmittelbar; in manchen Fällen kann es 24–48 Stunden dauern. Die aggregierten Werte shareCount, likeCount und commentCount für persönliche Profile sind Best-Effort und können geringfügig von den in der LinkedIn-UI angezeigten Werten abweichen.
  • TikTok kann 24–48 Stunden benötigen, um seine Analytics-Daten zu aktualisieren, etwa Videoaufrufe, Demografie, Likes, Shares und Kommentare.
  • Weitere Informationen finden Sie im Post-Analytics-Endpunkt.

Header-Parameter

Body-Parameter

platforms
array
erforderlich
Social-Media-Plattformen, für die Analytics abgerufen werden sollen. Akzeptiert ein Array von Strings mit den folgenden Werten:
quarters
integer
Gibt an, wie viele Quartale historische Daten zurückgegeben werden sollen. Ein Quartal umfasst:
  • 85 Tage für Facebook
  • 90 Tage für Instagram, TikTok und YouTube
  • 90 Tage für Snapchat (aufgrund von Snapchat-API-Einschränkungen auf max. 1 Quartal / 90 Tage begrenzt)
Verfügbar für die Plattformen Facebook, Instagram, Snapchat, TikTok und YouTube. Gültige Werte: 1–4. Nur Werte größer als 0 aktivieren die Datumsfilterung.Datumsfilterung (Instagram & TikTok): Die Datumsfilterung ist aktiv, wenn daily=true ODER quarters > 0. Wenn weder daily noch quarters angegeben wird, werden alle Daten ohne Datumsfilter zurückgegeben.Hinweis: quarters: 0 wird jetzt so behandelt, als wäre kein Datumsbereich angegeben (alle Daten). Zuvor wurde quarters: 0 wie quarters: 1 behandelt.
daily
boolean
Standard:false
Wenn auf true gesetzt, werden Analytics-Daten als tägliche Zeitreihenwerte statt als aggregierte Summen zurückgegeben. Diese Option ist nur für die Plattformen Facebook, Instagram, Snapchat, TikTok und YouTube verfügbar. Aufgrund der größeren Datenmenge wird die Verwendung von Kompression empfohlen.Für Instagram und TikTok aktiviert daily=true außerdem die Datumsfilterung mit einem standardmäßig kürzeren Quartalsfenster.Instagram-Reach: Bei daily=true gibt die Instagram-Antwort ein verschachteltes reach-Objekt zurück (mit period und einer Zeitreihe values) anstelle des skalaren Felds reachCount, das im Nicht-Daily-Modus zurückgegeben wird.
period60Days
boolean
Standard:false
Bei TikTok-Analytics werden, wenn dieser Wert auf true gesetzt ist, nur die aggregierten 60-Tage-Summen für Kommentare, Shares und Aufrufe zurückgegeben (commentCountTotal, shareCountTotal, viewCountTotal). Das führt im Vergleich zum Abruf der gesamten Analytics-Historie zu schnelleren Antwortzeiten. Hinweis: Verwenden Sie diesen Parameter nicht zusammen mit daily=true, da beide inkompatibel sind.Wichtig: Seit dem 1. März 2025 verwendet TikTok 60-Tage-Summen. Seit April 2026 nutzt TikTok die quartalbasierte Datumsfilterung – verwenden Sie den Parameter quarters, um das Zeitfenster zu steuern (z. B. quarters: 1 = 90 Tage, quarters: 2 = 180 Tage). Details finden Sie unter upcoming changes.
youtube
object
Plattformspezifische Optionen für YouTube-Analytics.lifetime (boolean, Standard: false): Wenn auf true gesetzt, wird lifetimeLikes in die Antwort aufgenommen – die Summe der Likes aller öffentlichen Videos auf dem Kanal. Dieser Wert wird berechnet, indem alle Videos abgerufen und deren Like-Zahlen addiert werden. Bei Kanälen mit vielen Videos kann das länger dauern.Schwellenwert: Kanäle mit mehr als 1.000 Videos geben lifetimeLikes: null sowie eine Warnung im obersten Array warnings zurück. Das verhindert eine übermäßige API-Nutzung.Caching: Pro Kanal, mit kürzeren TTLs für nicht-erfolgreiche Ergebnisse, damit Wiederholungen Zustandsänderungen zeitnah erkennen:
  • Erfolgreicher lifetimeLikes-Wert: 24 Stunden.
  • Abbruch bei 1.000 Videos (Warnung code: 445): 1 Stunde — kurz genug, damit ein Kanal, der Videos löscht, um unter den Schwellenwert zu fallen, keinen ganzen Tag auf einen echten Wert warten muss.
  • Vorübergehende Fehler der YouTube Data API (Warnung code: 446): nicht gecacht — die nächste Anfrage versucht es erneut.
Hinweis: Gelöschte oder private Videos werden aus der Summe ausgeschlossen. Bei Kanälen, die Videos entfernt haben, kann die Summe daher von den „tatsächlichen” Lifetime-Likes abweichen.Anfragebeispiel:
userId
string
Nur X/Twitter. Mit diesem Parameter können Sie Beiträge eines bestimmten X/Twitter-Nutzers anhand seiner numerischen ID abrufen – statt aus Ihrem verknüpften Konto.Um zum Beispiel alle Beiträge des Handles @Google zu erhalten, würden Sie die numerische userId 20536157 verwenden.Die numerische userId eines beliebigen X/Twitter-Nutzers finden Sie über den Endpunkt Brands Get User.Hinweis: Verwenden Sie für diese Anfrage nur den API KEY im Header. Fügen Sie den Profile Key nicht hinzu.
userName
string
Nur X/Twitter. Mit diesem Parameter können Sie Beiträge eines bestimmten X/Twitter-Nutzers anhand seines Handles abrufen – statt aus Ihrem verknüpften Konto.Zum Beispiel, um alle Beiträge des Handles @Google zu erhalten.Hinweis: Verwenden Sie für diese Anfrage nur den API KEY im Header. Fügen Sie den Profile Key nicht hinzu.
Wenn kumulative Kennzahlen (z. B. Follower, Likes) 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 reactions: Die auf Beitragsebene kumulative Kennzahl reactions (ein Objekt mit Reaktionszählungen pro Typ) unterliegt diesem ausschließlich auf leere Werte bezogenen Backfill. Wenn LinkedIn den Abruf der Reaktionen ratenbegrenzt, wird der Wert aus dem letzten erfolgreichen Snapshot übernommen – und backfilledFrom wird auf den Zeitstempel dieses Snapshots gesetzt – anstatt auf leer zurückzufallen.
LinkedIn-Personal (Member) Analytics — erneute Verknüpfung erforderlich. Persönliche LinkedIn-Profile, die vor der Einführung der Member-Analytics verknüpft wurden, verfügen nicht über die erforderlichen Analytics-Scopes. Social-Analytics-Anfragen für diese Profile liefern Fehlercode 475 („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.
warnings (Array von Objekten, optionales Feld auf oberster Ebene) — Nur vorhanden, wenn Ayrshare den Aufrufer über eine nicht-fatale Bedingung informieren muss (z. B. wurde eine Opt-in-Berechnung übersprungen). Fehlt in der Antwort, wenn nichts zu melden ist.Jeder Eintrag ist ein strukturiertes Objekt, kein freier Text:
FeldTypBeschreibung
actionstringOperationskontext, der die Warnung erzeugt hat (z. B. "analytics").
statusstringImmer "warning" für Einträge im Array warnings.
codenumberStabiler Ayrshare-Warnungscode. Kann sicher im Client-Code abgeglichen werden.
messagestringMenschenlesbare Beschreibung.
detailsstringOptionaler zusätzlicher Kontext zu dieser Warnungsinstanz.
Bekannte Warnungscodes:
  • 445lifetimeLikes wurde übersprungen, weil der YouTube-Kanal den Schwellenwert von 1.000 Videos überschreitet.
  • 446lifetimeLikes nicht verfügbar, da die YouTube Data API für die Uploads-Playlist oder jeden videos.list-Batch Fehler zurückgab.