Skip to main content
Die folgenden Änderungen an der API werden zum angegebenen Datum wirksam. Bitte prüfen Sie sorgfältig auf mögliche Breaking Changes. Siehe What’s New für alle neuen Funktionen.
​
  • Facebook: Meta hat Unique-Impression- (Reach) und 3-Sekunden-Video-View-Insights-Metriken eingestellt. Meta hat diese Metriken über alle Graph-API-Versionen entfernt, sodass die betroffenen Felder nicht mehr zurückgegeben werden. Details siehe Meta Graph API v25 Changelog.
    • GET analytics/post gibt die folgenden Facebook-Felder nicht mehr zurück:
      • impressionsUnique → auf mediaView umstellen
      • impressionsFanUnique → auf mediaView umstellen
      • impressionsOrganicUnique → auf mediaView umstellen
      • impressionsPaidUnique → auf mediaViewIsFromAds umstellen
      • videoViewsUnique → verwenden Sie videoViews für Non-Unique-3-Sekunden-Views
      • Die Familien totalVideoViews*Unique und totalVideoImpressions* (z. B. totalVideoViewsOrganicUnique, totalVideoViewsPaidUnique, totalVideoViewsUnique)
    • GET analytics/social gibt die folgenden Facebook-Felder nicht mehr zurück:
      • Die Familie pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*) → auf pageMediaView umstellen
      • pagePostsServedImpressionsOrganicUnique → auf pageMediaView umstellen
      • pageVideoViewsUnique → verwenden Sie pageVideoViews für Non-Unique-3-Sekunden-Views
    • Verwenden Sie mediaView / pageMediaView für Reach. Eine Total-Unique-Media-Views-Nachfolgemetrik ist geplant. Weiterhin unterstützte Felder wie reactionsByType, videoViews, mediaView, pagePostEngagements, pageVideoViews und pageVideoViewsPaid sind nicht betroffen.
​
  • Transiente YouTube-Fehler geben jetzt HTTP 503/504 statt 500 zurück: Einige YouTube-Upload-Fehler, die zuvor als HTTP 500 (code: 176) auftraten, geben jetzt HTTP 503 (code: 454) oder HTTP 504 (code: 453) zurück. Beide Antworten enthalten retryAvailable: true. Kundenintegrationen, die auf HTTP 500 filtern, um YouTube-Uploads zu wiederholen, sollten stattdessen auf das Feld retryAvailable im Response-Body filtern. Details siehe Fehlercodes.
​
  • Leere Analytics geben Fehler 187 zurück: Das Anfordern von Social Analytics oder Post Analytics, wenn keine Plattformen Daten zurückgeben, liefert nun { "status": "error", "code": 187 } anstelle von { "status": "success" }. Aktualisieren Sie jeglichen Client-Code, der sich auf das bisherige leere Erfolgsverhalten stützt.
​
  • X/Twitter-BYO-Key-Anforderung: Alle X/Twitter-Operationen über Ayrshare erfordern Ihre eigenen API-Zugangsdaten. Nach Verknüpfung Ihres X-Kontos über OAuth fügen Sie 2 Header in jede X/Twitter-Anfrage ein: X-Twitter-OAuth1-Api-Key und X-Twitter-OAuth1-Api-Secret. Anfragen ohne gültige Zugangsdaten werden abgelehnt. Anleitungen finden Sie im X-BYO-Key-Setup-Leitfaden.
  • RSS-to-X eingestellt: Das automatische RSS-Posting auf X/Twitter wird nach dem 31. März 2026 nicht mehr unterstützt. RSS-Feeds laufen nach einem Zeitplan ohne Zugangsdaten pro Anfrage, was mit dem BYO-Key-Modell nicht kompatibel ist. Das automatische RSS-Posting auf allen anderen Plattformen ist davon nicht betroffen.
  • X-Account-Activity-Webhook eingestellt: Die X-Account-Activity-Webhook-Aktion (accountActivity) wird nach dem 31. März 2026 nicht mehr verfügbar sein. Dies umfasst alle Echtzeit-Ereignisbenachrichtigungen für verknüpfte X-Konten (Posts, Erwähnungen, DMs, Likes, Follows, Blocks usw.).
​
  • Ab dem 14. November 2025 wird Facebook die folgenden Felder für GET analytics/social einstellen:
    • pageFans
    • pageFansCity
    • pageFansLocale
    • pageFansCountry
    • pageFansAdds
    • pageFanAddsUnique
    • pageFanRemoves
    • pageFanRemovesUnique
    • pageImpressions → auf pageMediaView umstellen
    • pageImpressionsPaidUnique → auf pageMediaViewIsFromAds umstellen
    • pageImpressionsUnique
    • pageImpressionsViral
    • pageImpressionsViralUnique
    • pageImpressionsPaid → auf pageMediaViewIsFromAds umstellen
  • Ab dem 14. November 2025 wird Facebook die folgenden Felder für GET analytics/post einstellen:
    • impressions und impressionsFanPaidUnique → auf mediaView umstellen. Detailliertere Aufschlüsselungen verfügbar über mediaViewIsFromAds (Werbe-attribuierte Views) und mediaViewIsFromFollowers (Follower-attribuierte Views).
    • postImpressionsUnique (Reels) → verwenden Sie blueReelsPlayCount für den Reel-Play-Count oder postVideoViewTime für die gesamte Wiedergabedauer.
​
  • Ab dem 1. September 2025 enthält der Get Comments-Endpoint für Instagram das Feld text in Reply-Objekten nicht mehr. Verwenden Sie stattdessen das Feld comment, um auf den Reply-Inhalt zuzugreifen.
​
  • Der Get Comments-Endpoint für X (Twitter) verschiebt die öffentlichen Nutzer-Metriken in das neue Objekt publicMetrics. Die folgenden Felder werden von der obersten Ebene in das Objekt publicMetrics verschoben:
    • followersCount
    • followingCount
    • tweetCount
    • listedCount
    • mediaCount
  • Facebook wird die folgenden Felder für GET analytics/social einstellen:
    • pageVideoViews10S
    • pageVideoViews10SAutoplayed
    • pageVideoViews10SClickToPlay
    • pageVideoViews10SOrganic
    • pageVideoViews10SPaid
    • pageVideoViews10SRepeat
    • pageVideoViews10SUnique
​
  • YouTube hat die Einstellung von erlaubten und blockierten Regionen eingestellt. Sie können erlaubte und blockierte Regionen weiterhin dem Post-Endpoint hinzufügen, sie werden jedoch ignoriert.
​
  • Die folgenden Metriken für Instagram-Post-Analytics werden eingestellt:REELS:
    • playsCount
    • clipsReplaysCount
    • igReelsAggregatedAllPlaysCount
    FEED/STORY:
    • impressionsCount
  • Der History-Endpoint erzwingt den Cache für 1 Minute, wenn limit größer als der Standardwert von 25 ist.
​
Der Get Comments-Endpoint für TikTok wird Feldnamen standardisieren, damit sie zu anderen sozialen Netzwerken passen.
  • Das Feld replyList wird in replies umbenannt und profileImage in profileImageUrl.
  • Beide neuen Feldnamen sind bereits verfügbar und können in Ihrer Integration verwendet werden.
  • TikTok hat die folgenden Updates:
    • social analytics-Endpoint: Die folgenden Änderungen kommen: • Das Feld durationAverage wird eingestellt und entfernt. • Aufgrund von TikTok-API- Einschränkungen geben die Felder shareCountTotal, viewCountTotal und commentCountTotal jetzt nur noch Summen der letzten 60 Tage statt All-Time-Summen zurück. • Um die 60-Tage- Summen jetzt schon zu nutzen, fügen Sie period60Days: true zu Ihrem API-Request-Body hinzu. Hinweis: Die Verwendung dieses Parameters verbessert die Antwortzeiten deutlich.
    • Endpoints history platform und post analytics: Die undokumentierten Felder caption, comments, shares, likes, shareUrl und itemsId werden entfernt – verwenden Sie stattdessen die Felder post, commentsCount, sharesCount, likesCount, postUrl und id.
​
Der /user-Endpoint ändert, wie die API-Nutzung berichtet wird:
  • Das Feld monthlyApiCalls wird erweitert, um alle API-Aufrufe (Posts, Kommentare, Analytics usw.) zu zählen.
  • Für Post-spezifische Zählungen verwenden Sie das neue Feld monthlyPostCount.
  • Das Feld monthlyApiCallsQuota wird eingestellt und durch das neue Feld monthlyPostQuota ersetzt.
​
  • Meta stellt das Feld videoViews am Instagram-Post-Analytics-Endpoint ein.
  • Zusätzlich werden die Felder emailContactsCount, getDirectionClicks, profileViewsCount, textMessageClicks, websiteClicksCount und phoneCallClicksCount aus dem Instagram-Social-Analytics-Endpoint entfernt.
  • Diese Felder werden am 5. Januar 2025 entfernt.
​
  • Zur Verbesserung der Sicherheit verhindern wir, dass Profile Keys als API-Keys verwendet werden. Wenn Sie versuchen, einen Profile Key statt des API-Keys zu verwenden, gibt das System einen Fehler zurück. Siehe hier, wie ein Profile Key korrekt verwendet wird.
​
  • Wir haben aktualisiert, wie Fehler für TikTok-Scheduled-Webhooks berichtet werden. Diese Fehler erscheinen jetzt im errors-Array, konsistent zur Fehlerbehandlung für andere Scheduled-Webhook-Typen. Beachten Sie: Die aktuellen Top-Level-Fehler werden weiterhin zurückgegeben, wir empfehlen jedoch die Nutzung des errors-Arrays.
  • Der History-Endpoint gibt Antworten jetzt standardmäßig als Objekte zurück. Der objResponse-Parameter wird automatisch auf true gesetzt.
  • Get All History LinkedIn gibt für das mediaUrls-Objekt ein Array zurück. Zuvor wurde ein Objekt zurückgegeben, wenn nur ein Medienelement vorhanden war, und ein Array, wenn mehrere Medienelemente vorhanden waren. Nun wird immer ein Array zurückgegeben, auch wenn nur ein einzelnes Medienelement enthalten ist. Wenn Sie das vorherige Verhalten benötigen, können Sie den Query-Parameter objResponse: false verwenden.
​
  • Der Media-Endpoint gibt url_1080 nicht mehr zurück. Wenn Sie ein Bild in der Größe ändern müssen, siehe den Resize-Endpoint.
​
  • Update 25. September 2024: Meta (Facebook) hat die Einstellung der Felder freigegeben, sodass die Entfernung der Felder wirksam ist. Bitte sehen Sie die aktualisierten Rückgaben in Social Analytics.
  • Facebook wird mehrere Felder einstellen. Der Social-Analytics-Endpoint gibt diese Felder nach dem 16. September 2024 nicht mehr zurück.
​
  • Das neue Link-Shortener-System ersetzt den Shortener-Endpoint, der von Google eingestellt wurde. Der neue Link-Shortener erfordert das Add-on Max Pack.
  • Link-Shortening ist standardmäßig deaktiviert (false). Um Links automatisch zu kürzen, verwenden Sie shortenLinks: true im Post-Endpoint-Aufruf, der den neuen Link-Endpoint verwendet.
​
  • Meta wird seine Facebook-Groups-API einstellen. Siehe die Ankündigung.
​
​
  • Die Standardantwort von Reply to comment with comment ID wird ein Objekt sein, wie in den Docs aufgeführt, anstelle eines Arrays. Sie können den Parameter objResponse auf boolean false setzen, wenn Sie eine Array-Antwort beibehalten möchten.
​
​
  • Die Felder caption, message, createdTime und timestamp des /history/instagram-Endpoints wurden am 1. April 2023 eingestellt und werden entfernt. Verwenden Sie stattdessen die Felder post und created.
  • Das Feld mediaUrls des /history/linkedin-Endpoints wird als Array anstelle eines Objekts zurückgegeben, um mehrere Bilder zu unterstützen. Sie können die Rückgabe als Array jetzt erzwingen, indem Sie den LinkedIn-Query-Parameter ?multiMedia=true einbeziehen. Beachten Sie, vor dem 1. Dezember 2023 muss der Query-Parameter multiMedia verwendet werden, um Medien mit mehreren Bildern zurückzugeben. Nach dem 1. Dezember 2023 werden mehrere Bilder standardmäßig zurückgegeben.
  • Beim Scheduled-Action-TikTok-Webhook wird das String-Feld platform eingestellt. Verwenden Sie das platforms-Array-Feld, wie es bei anderen Scheduled-Action-Webhooks der Fall ist.
  • Die Delete-Comment-Docs wurden korrigiert, um mit der korrekten Rückgabe übereinzustimmen.
  • Das TikTok-Feld commentId wird durch das Feld id ersetzt, um mit dem Standard-Comment-Delete-Format übereinzustimmen.
  • Die Twitter-Delete-Comment-Rückgabe enthält kein posts-Array mehr, damit die Rückgabe mit dem Standard-Comment-Delete-Format übereinstimmt. Die neue Rückgabe sieht wie folgt aus:
​
​
  • Wir haben auf die neue Twitter-API-Version 2 aktualisiert. Twitter hat einige Felder in Version 2 eingestellt, was die Endpoints /analytics/social und getAllHistory betrifft. Die folgenden Felder werden bis zum 1. September 2023 weiterhin zurückgegeben, haben aber einen Nullwert oder einen leeren String-Wert.
​
  • Wir freuen uns, TikTok Direct Publishing, Kommentarverwaltung und erweiterte Analytics zu veröffentlichen. Ihre Nutzer müssen die TikTok-Mobile-App nicht mehr öffnen, um zu posten und Caption-Text einzugeben. Nach dem Senden über Ayrshare werden das TikTok-Video und die Caption direkt veröffentlicht.
  • Wir führen außerdem das Hinzufügen, Abrufen und Löschen von TikTok-Kommentaren sowie demografische Analytics-Daten ein.
  • Ihre Nutzer müssen die Verknüpfung ihres TikTok-Kontos aufheben und erneut verknüpfen, um Direct Publishing zu aktivieren. Bestehende Verbindungen bleiben bei der indirekten Methode und erfordern die TikTok-Mobile-App zum Veröffentlichen.
​
  • Google Business Profile hat die verfügbaren Social-Analytics-Daten geändert. Die neuen verfügbaren Felder sind wie folgt. Vorherige Felder bleiben vorhanden, jedoch mit Nullwert, und werden am 17. März 2023 vollständig entfernt.
​
  • Die Beschreibungsfelder text und message für Get All Posts wurden auf das Feld post standardisiert.
​
  • Eingestellte TikTok-Felder: shareUrl. Verwenden Sie stattdessen postUrl.
​
  • Für alle History-Endpoints werden die Felder createdAt, createdTime und timestamp durch das Feld created ersetzt, das die Erstellungszeit im UTC-Format zurückgibt.
  • Das Feld scheduleDate wird nicht mehr ein Objekt, sondern einen String mit der geplanten Zeit im UTC-Format zurückgeben.
  • Das undokumentierte Feld created_date in /history wird entfernt. Verwenden Sie stattdessen created.
​
  • Analytics zu einem Facebook-Post gibt reactions als Objekt im folgenden Format zurück.
​
  • History gibt standardmäßig die letzten 20 Beiträge zurück. Mit dem Parameter lastRecords können bis zu 500 zurückgegeben werden.