> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bevorstehende API-Änderungen

> Änderungen an der API, die Ihre Integration betreffen können

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](/whatsnew/latest) für alle neuen Funktionen.

<Update label="15. Juni 2026">
  <ul class="custom-bullets">
    <li>
      **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](https://developers.facebook.com/blog/post/2026/02/18/introducing-graph-api-v25-and-marketing-api-v25/).

      <ul class="custom-bullets">
        <li>
          [GET analytics/post](/apis/analytics/post) gibt die folgenden Facebook-Felder nicht mehr zurück:

          <ul class="custom-bullets">
            <li>impressionsUnique → auf `mediaView` umstellen</li>
            <li>impressionsFanUnique → auf `mediaView` umstellen</li>
            <li>impressionsOrganicUnique → auf `mediaView` umstellen</li>
            <li>impressionsPaidUnique → auf `mediaViewIsFromAds` umstellen</li>
            <li>videoViewsUnique → verwenden Sie `videoViews` für Non-Unique-3-Sekunden-Views</li>
            <li>Die Familien `totalVideoViews*Unique` und `totalVideoImpressions*` (z. B. `totalVideoViewsOrganicUnique`, `totalVideoViewsPaidUnique`, `totalVideoViewsUnique`)</li>
          </ul>
        </li>

        <li>
          [GET analytics/social](/apis/analytics/social) gibt die folgenden Facebook-Felder nicht mehr zurück:

          <ul class="custom-bullets">
            <li>Die Familie `pagePostsImpressions*` (`pagePostsImpressions`, `pagePostsImpressionsPaid`, `pagePostsImpressionsUnique`, `pagePostsImpressionsOrganicUnique`, `pagePostsImpressionsViral*`, `pagePostsImpressionsNonviral*`) → auf `pageMediaView` umstellen</li>
            <li>pagePostsServedImpressionsOrganicUnique → auf `pageMediaView` umstellen</li>
            <li>pageVideoViewsUnique → verwenden Sie `pageVideoViews` für Non-Unique-3-Sekunden-Views</li>
          </ul>
        </li>

        <li>
          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.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="11. Mai 2026">
  <ul class="custom-bullets">
    <li>
      **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](/errors/errors-ayrshare).
    </li>
  </ul>
</Update>

<Update label="9. April 2026">
  <ul class="custom-bullets">
    <li>
      **Leere Analytics geben Fehler 187 zurück:** Das Anfordern von [Social Analytics](/apis/analytics/social) oder [Post Analytics](/apis/analytics/post), 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.
    </li>
  </ul>
</Update>

<Update label="31. März 2026">
  <ul class="custom-bullets">
    <li>
      **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](/dashboard/connect-social-accounts/x-twitter-byo-keys).
    </li>

    <li>
      **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.
    </li>

    <li>
      **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.).
    </li>
  </ul>
</Update>

<Update label="14. November 2025">
  <ul class="custom-bullets">
    <li>
      Ab dem 14. November 2025 wird Facebook die folgenden Felder für [GET analytics/social](/apis/analytics/social) einstellen:

      <ul class="custom-bullets">
        <li>pageFans</li>
        <li>pageFansCity</li>
        <li>pageFansLocale</li>
        <li>pageFansCountry</li>
        <li>pageFansAdds</li>
        <li>pageFanAddsUnique</li>
        <li>pageFanRemoves</li>
        <li>pageFanRemovesUnique</li>
        <li>pageImpressions → auf `pageMediaView` umstellen</li>
        <li>pageImpressionsPaidUnique → auf `pageMediaViewIsFromAds` umstellen</li>
        <li>pageImpressionsUnique</li>
        <li>pageImpressionsViral</li>
        <li>pageImpressionsViralUnique</li>
        <li>pageImpressionsPaid → auf `pageMediaViewIsFromAds` umstellen</li>
      </ul>
    </li>

    <li>
      Ab dem 14. November 2025 wird Facebook die folgenden Felder für [GET analytics/post](/apis/analytics/post) einstellen:

      <ul class="custom-bullets">
        <li>impressions und impressionsFanPaidUnique → auf `mediaView` umstellen. Detailliertere Aufschlüsselungen verfügbar über `mediaViewIsFromAds` (Werbe-attribuierte Views) und `mediaViewIsFromFollowers` (Follower-attribuierte Views).</li>
        <li>postImpressionsUnique (Reels) → verwenden Sie `blueReelsPlayCount` für den Reel-Play-Count oder `postVideoViewTime` für die gesamte Wiedergabedauer.</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1. September 2025">
  <ul class="custom-bullets">
    <li>
      Ab dem 1. September 2025 enthält der [Get Comments](/apis/comments/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.
    </li>
  </ul>
</Update>

<Update label="1. Juni 2025">
  <ul class="custom-bullets">
    <li>
      Der [Get Comments](/apis/comments/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:

      <ul class="custom-bullets">
        <li>followersCount</li>
        <li>followingCount</li>
        <li>tweetCount</li>
        <li>listedCount</li>
        <li>mediaCount</li>
      </ul>
    </li>

    <li>
      Facebook wird die folgenden Felder für [GET analytics/social](/apis/analytics/social) einstellen:

      <ul class="custom-bullets">
        <li>pageVideoViews10S</li>
        <li>pageVideoViews10SAutoplayed</li>
        <li>pageVideoViews10SClickToPlay</li>
        <li>pageVideoViews10SOrganic</li>
        <li>pageVideoViews10SPaid</li>
        <li>pageVideoViews10SRepeat</li>
        <li>pageVideoViews10SUnique</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="7. Mai 2025">
  <ul class="custom-bullets">
    <li>
      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.
    </li>
  </ul>
</Update>

<Update label="20. April 2025">
  <ul class="custom-bullets">
    <li>
      Die folgenden Metriken für [Instagram-Post-Analytics](/apis/analytics/post) werden eingestellt:

      REELS:

      <ul class="custom-bullets">
        <li>
          playsCount
        </li>

        <li>
          clipsReplaysCount
        </li>

        <li>
          igReelsAggregatedAllPlaysCount
        </li>
      </ul>

      FEED/STORY:

      <ul class="custom-bullets">
        <li>
          impressionsCount
        </li>
      </ul>
    </li>

    <li>
      Der [History-Endpoint](/apis/history/get-history) erzwingt den Cache für 1 Minute, wenn `limit` größer als der Standardwert von 25 ist.
    </li>
  </ul>
</Update>

<Update label="1. März 2025">
  Der [Get Comments](/apis/comments/get-comments)-Endpoint für TikTok wird Feldnamen standardisieren, damit sie zu anderen sozialen Netzwerken passen.

  <ul class="custom-bullets">
    <li>
      Das Feld `replyList` wird in `replies` umbenannt und `profileImage` in
      `profileImageUrl`.
    </li>

    <li>Beide neuen Feldnamen sind bereits verfügbar und können in Ihrer Integration verwendet werden.</li>

    <li>
      TikTok hat die folgenden Updates:

      <ul class="custom-bullets">
        <li>
          [social analytics](/apis/analytics/social)-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.
        </li>

        <li>
          Endpoints [history platform](/apis/history/history-platform) und [post
          analytics](/apis/analytics/post): Die undokumentierten Felder `caption`, `comments`,
          `shares`, `likes`, `shareUrl` und `itemsId` werden entfernt – verwenden Sie stattdessen die Felder `post`,
          `commentsCount`, `sharesCount`, `likesCount`, `postUrl` und `id`.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1. Februar 2025">
  Der [/user](/apis/user/profile-details)-Endpoint ändert, wie die API-Nutzung berichtet wird:

  <ul class="custom-bullets">
    <li>
      Das Feld `monthlyApiCalls` wird erweitert, um alle API-Aufrufe (Posts, Kommentare, Analytics usw.)
      zu zählen.
    </li>

    <li>Für Post-spezifische Zählungen verwenden Sie das neue Feld `monthlyPostCount`.</li>

    <li>
      Das Feld `monthlyApiCallsQuota` wird eingestellt und durch das neue Feld `monthlyPostQuota` ersetzt.
    </li>
  </ul>
</Update>

<Update label="5. Januar 2025">
  <ul class="custom-bullets">
    <li>
      Meta stellt das Feld `videoViews` am Instagram-[Post-Analytics-Endpoint](/apis/analytics/post) ein.
    </li>

    <li>
      Zusätzlich werden die Felder `emailContactsCount`, `getDirectionClicks`, `profileViewsCount`,
      `textMessageClicks`, `websiteClicksCount` und `phoneCallClicksCount` aus dem Instagram-[Social-Analytics](/apis/analytics/social)-Endpoint entfernt.
    </li>

    <li>Diese Felder werden am 5. Januar 2025 entfernt.</li>
  </ul>
</Update>

<Update label="15. Dezember 2024">
  <ul class="custom-bullets">
    <li>
      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](/apis/overview#authorization), wie ein Profile Key korrekt verwendet wird.
    </li>
  </ul>
</Update>

<Update label="15. November 2024">
  <ul class="custom-bullets">
    <li>
      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.
    </li>

    <li>
      Der History-Endpoint gibt Antworten jetzt standardmäßig als Objekte zurück. Der objResponse-Parameter wird automatisch auf true gesetzt.
    </li>

    <li>
      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.
    </li>
  </ul>
</Update>

<Update label="7. Oktober 2024">
  <ul class="custom-bullets">
    <li>
      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](/apis/media/resize).
    </li>
  </ul>
</Update>

<Update label="16. September 2024">
  <ul class="custom-bullets">
    <li>
      **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](/apis/analytics/social).
    </li>

    <li>
      Facebook wird [mehrere Felder einstellen](https://developers.facebook.com/docs/pages-api/changelog/). Der [Social-Analytics-Endpoint](/apis/analytics/social-by-id) gibt diese Felder nach dem 16. September 2024 nicht mehr zurück.
    </li>
  </ul>
</Update>

<Update label="3. Juni 2024">
  <ul class="custom-bullets">
    <li>
      Das [neue Link-Shortener-System](/apis/links/overview) ersetzt den Shortener-Endpoint, der von Google eingestellt wurde. Der neue Link-Shortener erfordert das Add-on [Max Pack](/additional/maxpack).
    </li>

    <li>
      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](/apis/links/overview) verwendet.
    </li>
  </ul>
</Update>

<Update label="22. April 2024">
  <ul class="custom-bullets">
    <li>
      Meta wird seine Facebook-Groups-API einstellen. Siehe die [Ankündigung](https://www.ayrshare.com/blog/facebook-removes-groups-api-access-impact-and-implications/).
    </li>
  </ul>
</Update>

<Update label="16. April 2024">
  <ul class="custom-bullets">
    <li>
      Instagram hat den Zeitraum des Datensatzes „Online-Follower" präzisiert. [Details finden Sie hier](/apis/analytics/instagram-follower-count).
    </li>
  </ul>
</Update>

<Update label="1. April 2024">
  <ul class="custom-bullets">
    <li>
      Die Standardantwort von [Reply to comment with comment ID](/apis/comments/reply-to-comment) 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.
    </li>
  </ul>
</Update>

<Update label="25. Januar 2024">
  <ul class="custom-bullets">
    <li>
      Der [Retry-Post-Endpoint](/apis/post/retry-post) gibt einen Status von „pending" statt „success" zurück, um den Status des Retries besser widerzuspiegeln.
    </li>

    <li>
      Die [API-Änderungen bei scheduleDate und createDate](/whatsnew/upcoming-api-changes#changes-in-effect-june-17-2022) werden veröffentlicht.
    </li>
  </ul>
</Update>

<Update label="8. Dezember 2023">
  <ul class="custom-bullets">
    <li>
      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`.
    </li>

    <li>
      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.
    </li>

    <li>
      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.
    </li>

    <li>Die Delete-Comment-Docs wurden korrigiert, um mit der korrekten Rückgabe übereinzustimmen.</li>

    <li>
      Das TikTok-Feld commentId wird durch das Feld id ersetzt, um mit dem Standard-Comment-Delete-Format übereinzustimmen.
    </li>

    <li>
      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:
    </li>
  </ul>
</Update>

<Update label="18. Oktober 2023">
  <ul class="custom-bullets">
    <li>
      Die folgenden YouTube-Felder des [Social-Analytics-Endpoints](/apis/analytics/social) werden als numerische Werte statt als String-Werte zurückgegeben.
    </li>
  </ul>
</Update>

<Update label="30. Mai 2023">
  <ul class="custom-bullets">
    <li>
      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.
    </li>
  </ul>
</Update>

<Update label="8. Mai 2023">
  <ul class="custom-bullets">
    <li>
      Wir freuen uns, [TikTok Direct Publishing](/apis/post/social-networks/tiktok), 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.
    </li>

    <li>
      Wir führen außerdem das Hinzufügen, Abrufen und Löschen von TikTok-Kommentaren sowie demografische Analytics-Daten ein.
    </li>

    <li>
      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.
    </li>
  </ul>
</Update>

<Update label="17. Februar 2023">
  <ul class="custom-bullets">
    <li>
      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.
    </li>
  </ul>
</Update>

<Update label="1. Oktober 2022">
  <ul class="custom-bullets">
    <li>Die Beschreibungsfelder text und message für Get All Posts wurden auf das Feld `post` standardisiert.</li>
  </ul>
</Update>

<Update label="12. September 2022">
  <ul class="custom-bullets">
    <li>Eingestellte TikTok-Felder: `shareUrl`. Verwenden Sie stattdessen `postUrl`.</li>
  </ul>
</Update>

<Update label="17. Juni 2022">
  <ul class="custom-bullets">
    <li>
      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.
    </li>

    <li>
      Das Feld `scheduleDate` wird nicht mehr ein Objekt, sondern einen String mit der geplanten Zeit im UTC-Format zurückgeben.
    </li>

    <li>
      Das undokumentierte Feld `created_date` in /history wird entfernt. Verwenden Sie stattdessen `created`.
    </li>
  </ul>
</Update>

<Update label="22. April 2022">
  <ul class="custom-bullets">
    <li>
      Analytics zu einem [Facebook-Post](/apis/analytics/post) gibt `reactions` als Objekt im folgenden Format zurück.
    </li>
  </ul>
</Update>

<Update label="1. April 2022">
  <ul class="custom-bullets">
    <li>
      History gibt standardmäßig die letzten 20 Beiträge zurück. Mit dem Parameter `lastRecords` können bis zu 500 zurückgegeben werden.
    </li>
  </ul>
</Update>