> ## 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.

# Changements API à venir

> Modifications de l'API pouvant impacter votre intégration

Les modifications suivantes de l'API seront effectives à la date indiquée.
Veuillez examiner attentivement pour identifier tout changement potentiellement incompatible.
Consultez [Quoi de neuf](/whatsnew/latest) pour toutes les nouvelles fonctionnalités.

<Update label="15 juin 2026">
  <ul class="custom-bullets">
    <li>
      **Facebook : Meta a retiré les métriques Insights unique-impression (reach) et video-view de 3 secondes.** Meta a supprimé ces métriques dans toutes les versions de la Graph API, les champs affectés ne sont donc plus renvoyés. Consultez le [changelog de Meta Graph API v25](https://developers.facebook.com/blog/post/2026/02/18/introducing-graph-api-v25-and-marketing-api-v25/) pour plus de détails.

      <ul class="custom-bullets">
        <li>
          [GET analytics/post](/apis/analytics/post) ne renvoie plus les champs Facebook suivants :

          <ul class="custom-bullets">
            <li>impressionsUnique → migrez vers `mediaView`</li>
            <li>impressionsFanUnique → migrez vers `mediaView`</li>
            <li>impressionsOrganicUnique → migrez vers `mediaView`</li>
            <li>impressionsPaidUnique → migrez vers `mediaViewIsFromAds`</li>
            <li>videoViewsUnique → utilisez `videoViews` pour les vues non uniques de 3 secondes</li>
            <li>Les familles `totalVideoViews*Unique` et `totalVideoImpressions*` (par exemple `totalVideoViewsOrganicUnique`, `totalVideoViewsPaidUnique`, `totalVideoViewsUnique`)</li>
          </ul>
        </li>

        <li>
          [GET analytics/social](/apis/analytics/social) ne renvoie plus les champs Facebook suivants :

          <ul class="custom-bullets">
            <li>La famille `pagePostsImpressions*` (`pagePostsImpressions`, `pagePostsImpressionsPaid`, `pagePostsImpressionsUnique`, `pagePostsImpressionsOrganicUnique`, `pagePostsImpressionsViral*`, `pagePostsImpressionsNonviral*`) → migrez vers `pageMediaView`</li>
            <li>pagePostsServedImpressionsOrganicUnique → migrez vers `pageMediaView`</li>
            <li>pageVideoViewsUnique → utilisez `pageVideoViews` pour les vues non uniques de 3 secondes</li>
          </ul>
        </li>

        <li>
          Utilisez `mediaView` / `pageMediaView` pour le reach. Une métrique successeur Total Unique Media Views est prévue. Les champs toujours pris en charge tels que `reactionsByType`, `videoViews`, `mediaView`, `pagePostEngagements`, `pageVideoViews` et `pageVideoViewsPaid` ne sont pas affectés.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="11 mai 2026">
  <ul class="custom-bullets">
    <li>
      **Les échecs transitoires de YouTube renvoient désormais HTTP 503/504 au lieu de 500 :** certains échecs de téléchargement YouTube précédemment renvoyés sous HTTP 500 (`code: 176`) renvoient désormais HTTP 503 (`code: 454`) ou HTTP 504 (`code: 453`). Les deux réponses incluent `retryAvailable: true`. Les intégrations clients qui filtrent sur HTTP 500 pour relancer les téléchargements YouTube devraient passer au filtrage sur le champ `retryAvailable` du corps de la réponse. Consultez les [codes d'erreur](/errors/errors-ayrshare) pour plus de détails.
    </li>
  </ul>
</Update>

<Update label="9 avril 2026">
  <ul class="custom-bullets">
    <li>
      **Les statistiques vides renvoient l'erreur 187 :** demander [Social Analytics](/apis/analytics/social) ou [Post Analytics](/apis/analytics/post) lorsqu'aucune plateforme ne renvoie de données retourne désormais `{ "status": "error", "code": 187 }` au lieu de `{ "status": "success" }`. Mettez à jour tout code client qui repose sur le comportement précédent de succès vide.
    </li>
  </ul>
</Update>

<Update label="31 mars 2026">
  <ul class="custom-bullets">
    <li>
      **Exigence de X/Twitter BYO Key :** toutes les opérations X/Twitter via Ayrshare nécessiteront vos propres identifiants API. Après avoir lié votre compte X via OAuth, incluez 2 en-têtes dans chaque requête X/Twitter : `X-Twitter-OAuth1-Api-Key` et `X-Twitter-OAuth1-Api-Secret`. Les requêtes sans identifiants valides seront rejetées. Consultez le [guide de configuration X BYO Key](/dashboard/connect-social-accounts/x-twitter-byo-keys) pour les instructions.
    </li>

    <li>
      **RSS-to-X déprécié :** la publication automatique RSS sur X/Twitter ne sera plus prise en charge après le 31 mars 2026. Les flux RSS s'exécutent selon un calendrier sans identifiants par requête, ce qui est incompatible avec le modèle BYO key. La publication automatique RSS sur toutes les autres plateformes n'est pas affectée.
    </li>

    <li>
      **X Account Activity Webhook déprécié :** l'action webhook X Account Activity (`accountActivity`) ne sera plus disponible après le 31 mars 2026. Cela inclut toutes les notifications d'événements en temps réel pour les comptes X liés (publications, mentions, DM, likes, follows, blocks, etc.).
    </li>
  </ul>
</Update>

<Update label="14 novembre 2025">
  <ul class="custom-bullets">
    <li>
      À partir du 14 novembre 2025, Facebook dépréciera les champs suivants pour [GET analytics/social](/apis/analytics/social) :

      <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 → migrez vers `pageMediaView`</li>
        <li>pageImpressionsPaidUnique → migrez vers `pageMediaViewIsFromAds`</li>
        <li>pageImpressionsUnique</li>
        <li>pageImpressionsViral</li>
        <li>pageImpressionsViralUnique</li>
        <li>pageImpressionsPaid → migrez vers `pageMediaViewIsFromAds`</li>
      </ul>
    </li>

    <li>
      À partir du 14 novembre 2025, Facebook dépréciera les champs suivants pour [GET analytics/post](/apis/analytics/post) :

      <ul class="custom-bullets">
        <li>impressions et impressionsFanPaidUnique → migrez vers `mediaView`. Répartitions granulaires disponibles via `mediaViewIsFromAds` (vues attribuées aux publicités) et `mediaViewIsFromFollowers` (vues attribuées aux abonnés).</li>
        <li>postImpressionsUnique (Reels) → utilisez `blueReelsPlayCount` pour le nombre de lectures de reel ou `postVideoViewTime` pour le temps total de visionnage.</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1er septembre 2025">
  <ul class="custom-bullets">
    <li>
      À partir du 1er septembre 2025, le point de terminaison [get comments](/apis/comments/get-comments) pour
      Instagram n'inclura plus le champ `text` dans les objets de réponse. Utilisez le champ `comment`
      à la place pour accéder au contenu de la réponse.
    </li>
  </ul>
</Update>

<Update label="1er juin 2025">
  <ul class="custom-bullets">
    <li>
      Le point de terminaison [get comments](/apis/comments/get-comments) de X (Twitter) déplacera les métriques publiques
      de l'utilisateur vers le nouvel objet `publicMetrics`. Les champs suivants seront déplacés du
      niveau supérieur vers l'objet `publicMetrics` :

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

    <li>
      Facebook dépréciera les champs suivants pour [GET
      analytics/social](/apis/analytics/social) :

      <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 a déprécié la configuration des régions autorisées et bloquées. Vous pouvez toujours ajouter les
      régions autorisées et bloquées au point de terminaison post, mais elles seront ignorées.
    </li>
  </ul>
</Update>

<Update label="20 avril 2025">
  <ul class="custom-bullets">
    <li>
      Les métriques suivantes pour les [statistiques de publication Instagram](/apis/analytics/post) seront dépréciées :

      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>
      Le [point de terminaison history](/apis/history/get-history) appliquera le cache pendant 1 minute si la `limit` est supérieure à la valeur par défaut de 25.
    </li>
  </ul>
</Update>

<Update label="1er mars 2025">
  Le point de terminaison [get comments](/apis/comments/get-comments) pour TikTok standardisera les noms de champs
  pour correspondre aux autres réseaux sociaux.

  <ul class="custom-bullets">
    <li>
      Le champ `replyList` sera renommé en `replies` et `profileImage` sera renommé en
      `profileImageUrl`.
    </li>

    <li>Les deux nouveaux noms de champs sont déjà disponibles et peuvent être utilisés dans votre intégration.</li>

    <li>
      TikTok a les mises à jour suivantes :

      <ul class="custom-bullets">
        <li>
          Point de terminaison [social analytics](/apis/analytics/social) : les modifications suivantes arrivent : •
          Le champ `durationAverage` sera déprécié et supprimé. • En raison des limitations
          de l'API TikTok, les champs `shareCountTotal`, `viewCountTotal` et `commentCountTotal` ne
          renverront désormais que les totaux des 60 derniers jours au lieu des totaux de tous les temps. • Pour commencer à utiliser
          les totaux de 60 jours dès maintenant, ajoutez `period60Days: true` au corps de votre requête API. Remarque : l'utilisation de ce
          paramètre améliorera considérablement les temps de réponse.
        </li>

        <li>
          Points de terminaison [history platform](/apis/history/history-platform) et [post
          analytics](/apis/analytics/post) : les champs non documentés `caption`, `comments`,
          `shares`, `likes`, `shareUrl` et `itemsId` seront supprimés - les champs `post`,
          `commentsCount`, `sharesCount`, `likesCount`, `postUrl` et `id` doivent être utilisés à la place.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1er février 2025">
  Le point de terminaison [/user](/apis/user/profile-details) change sa façon de signaler l'utilisation de l'API :

  <ul class="custom-bullets">
    <li>
      Le champ `monthlyApiCalls` sera étendu pour compter tous les appels API (publications, commentaires,
      statistiques, etc.).
    </li>

    <li>Pour les décomptes spécifiques aux publications, utilisez le nouveau champ `monthlyPostCount`.</li>

    <li>
      Le champ `monthlyApiCallsQuota` sera déprécié et remplacé par le nouveau champ `monthlyPostQuota`.
    </li>
  </ul>
</Update>

<Update label="5 janvier 2025">
  <ul class="custom-bullets">
    <li>
      Meta déprécie le champ `videoViews` sur le [point de terminaison des statistiques de publication
      Instagram](/apis/analytics/post).
    </li>

    <li>
      De plus, les champs `emailContactsCount`, `getDirectionClicks`, `profileViewsCount`,
      `textMessageClicks`, `websiteClicksCount` et `phoneCallClicksCount` seront supprimés
      du point de terminaison [social analytics](/apis/analytics/social) Instagram.
    </li>

    <li>Ces champs seront supprimés le 5 janvier 2025.</li>
  </ul>
</Update>

<Update label="15 décembre 2024">
  <ul class="custom-bullets">
    <li>
      Pour une sécurité renforcée, nous empêcherons l'utilisation des Profile Keys comme API Keys. Si vous
      tentez d'utiliser une Profile Key à la place de l'API Key, le système renverra une erreur. [Consultez
      ici](/apis/overview#authorization) comment utiliser correctement une Profile Key.
    </li>
  </ul>
</Update>

<Update label="15 novembre 2024">
  <ul class="custom-bullets">
    <li>
      Nous avons mis à jour la façon dont les erreurs pour les webhooks planifiés TikTok sont signalées. Ces erreurs apparaîtront désormais
      dans le tableau errors, conformément à notre gestion des erreurs pour les autres types de webhooks planifiés.
      Notez que les erreurs de niveau supérieur actuelles seront toujours renvoyées, mais nous encourageons l'utilisation du
      tableau errors.
    </li>

    <li>
      Le point de terminaison history renverra désormais les réponses sous forme d'objets par défaut. Le paramètre objResponse
      sera automatiquement défini sur true.
    </li>

    <li>
      Get All History LinkedIn renverra un tableau pour l'objet mediaUrls. Auparavant, un objet
      était renvoyé s'il n'y avait qu'un seul élément multimédia et un tableau s'il y avait plusieurs éléments multimédias. Maintenant, un tableau sera
      toujours renvoyé même s'il n'y a qu'un seul élément multimédia. Si vous avez besoin du comportement précédent, vous
      pouvez utiliser le paramètre de requête `objResponse: false`.
    </li>
  </ul>
</Update>

<Update label="7 octobre 2024">
  <ul class="custom-bullets">
    <li>
      Le point de terminaison media ne renverra plus url\_1080. Si vous devez redimensionner une image, veuillez
      consulter le [point de terminaison resize](/apis/media/resize).
    </li>
  </ul>
</Update>

<Update label="16 septembre 2024">
  <ul class="custom-bullets">
    <li>
      **Mise à jour du 25 septembre 2024** : Meta (Facebook) a publié la dépréciation des champs, donc la
      suppression des champs est en vigueur. Veuillez consulter les retours mis à jour dans [social
      analytics](/apis/analytics/social).
    </li>

    <li>
      Facebook [dépréciera plusieurs
      champs](https://developers.facebook.com/docs/pages-api/changelog/). Le [point de terminaison social analytics](/apis/analytics/social-by-id) ne renverra plus ces champs après le 16 septembre 2024.
    </li>
  </ul>
</Update>

<Update label="3 juin 2024">
  <ul class="custom-bullets">
    <li>
      Le [nouveau système de raccourcissement de liens](/apis/links/overview) remplacera le point de terminaison shortener,
      qui a été déprécié par Google. Le nouveau raccourcisseur de liens nécessite le module complémentaire [Max
      Pack](/additional/maxpack).
    </li>

    <li>
      Le raccourcissement de liens sera désactivé (`false`) par défaut. Pour raccourcir automatiquement les liens, utilisez
      `shortenLinks: true` dans l'appel du point de terminaison post, qui utilise le nouveau [point de terminaison link](/apis/links/overview).
    </li>
  </ul>
</Update>

<Update label="22 avril 2024">
  <ul class="custom-bullets">
    <li>
      Meta dépréciera son API Facebook Groups. Veuillez consulter l'[annonce](https://www.ayrshare.com/blog/facebook-removes-groups-api-access-impact-and-implications/).
    </li>
  </ul>
</Update>

<Update label="16 avril 2024">
  <ul class="custom-bullets">
    <li>
      Instagram a clarifié la période de temps de l'ensemble de données des abonnés en ligne. Veuillez consulter ici pour
      [plus de détails](/apis/analytics/instagram-follower-count).
    </li>
  </ul>
</Update>

<Update label="1er avril 2024">
  <ul class="custom-bullets">
    <li>
      La réponse par défaut de [Répondre à un commentaire avec un ID de commentaire](/apis/comments/reply-to-comment) sera
      un objet comme indiqué dans la documentation au lieu d'un tableau. Vous pouvez utiliser le paramètre objResponse défini
      sur le booléen `false` si vous souhaitez conserver une réponse en tableau.
    </li>
  </ul>
</Update>

<Update label="25 janvier 2024">
  <ul class="custom-bullets">
    <li>
      Le [point de terminaison retry post](/apis/post/retry-post) renverra un statut « pending » au lieu de
      « success » pour mieux refléter le statut de la relance.
    </li>

    <li>
      Les [modifications de l'API sur scheduleDate et
      createDate](/whatsnew/upcoming-api-changes#changes-in-effect-june-17-2022) seront publiées.
    </li>
  </ul>
</Update>

<Update label="8 décembre 2023">
  <ul class="custom-bullets">
    <li>
      Les champs `caption`, `message`, `createdTime` et `timestamp` du point de terminaison `/history/instagram`
      ont été dépréciés le 1er avril 2023 et seront supprimés. Veuillez utiliser les champs `post` et
      `created`.
    </li>

    <li>
      Le champ `mediaUrls` du point de terminaison `/history/linkedin` sera renvoyé sous forme de tableau au lieu d'un
      objet pour prendre en charge plusieurs images. Vous pouvez forcer le retour du tableau dès maintenant en incluant le
      paramètre de requête LinkedIn `?multiMedia=true`. Veuillez noter qu'avant le 1er décembre 2023, le
      paramètre de requête `multiMedia` doit être utilisé pour renvoyer les médias avec plusieurs images. Après le 1er décembre
      2023, plusieurs images seront renvoyées par défaut.
    </li>

    <li>
      Le Scheduled Action TikTok webhook aura le String `platform` déprécié. Veuillez utiliser le
      champ de tableau `platforms` comme cela est fait pour les autres Scheduled Action webhooks.
    </li>

    <li>La documentation delete comment a été corrigée pour s'aligner sur le retour correct.</li>

    <li>
      Le champ TikTok commentId sera remplacé par le champ id pour s'aligner sur le format standard de
      suppression de commentaire.
    </li>

    <li>
      Le retour de suppression de commentaire Twitter ne contiendra plus de tableau `posts` afin que le retour s'aligne
      sur le format standard de suppression de commentaire. Le nouveau retour sera le suivant :
    </li>
  </ul>
</Update>

<Update label="18 octobre 2023">
  <ul class="custom-bullets">
    <li>
      Les champs YouTube suivants du [point de terminaison social analytics](/apis/analytics/social) seront
      renvoyés sous forme de valeurs numériques au lieu de valeurs String.
    </li>
  </ul>
</Update>

<Update label="30 mai 2023">
  <ul class="custom-bullets">
    <li>
      Nous avons mis à niveau vers la nouvelle version 2 de l'API Twitter. Twitter a déprécié quelques champs dans la version
      2, ce qui affecte les points de terminaison /analytics/social et getAllHistory. Ces champs suivants
      seront toujours renvoyés jusqu'au 1er septembre 2023, mais auront une valeur nulle ou une chaîne vide.
    </li>
  </ul>
</Update>

<Update label="8 mai 2023">
  <ul class="custom-bullets">
    <li>
      Nous sommes ravis de lancer la [publication directe TikTok](/apis/post/social-networks/tiktok), la gestion des
      commentaires et les statistiques avancées. Vos utilisateurs n'auront plus besoin d'ouvrir leur application mobile TikTok
      pour publier et saisir le texte de la légende. Désormais, après l'envoi via Ayrshare, la vidéo TikTok et
      la légende sont directement publiées.
    </li>

    <li>
      Nous présentons également l'ajout, la récupération et la suppression de commentaires TikTok + les données statistiques démographiques.
    </li>

    <li>
      Votre utilisateur devra délier et relier son compte TikTok pour activer la publication directe.
      Les connexions existantes continueront avec la méthode indirecte et nécessiteront l'application mobile TikTok
      pour publier.
    </li>
  </ul>
</Update>

<Update label="17 février 2023">
  <ul class="custom-bullets">
    <li>
      Google Business Profile a modifié les données de statistiques sociales disponibles. Les nouveaux
      champs disponibles sont les suivants. Les champs précédents seront toujours présents, mais avec une valeur nulle
      et entièrement supprimés le 17 mars 2023.
    </li>
  </ul>
</Update>

<Update label="1er octobre 2022">
  <ul class="custom-bullets">
    <li>Les champs descriptions, text, message de Get All Posts sont standardisés vers le champ `post`.</li>
  </ul>
</Update>

<Update label="12 septembre 2022">
  <ul class="custom-bullets">
    <li>Champs TikTok dépréciés : `shareUrl`. Utilisez `postUrl` à la place.</li>
  </ul>
</Update>

<Update label="17 juin 2022">
  <ul class="custom-bullets">
    <li>
      Pour tous les points de terminaison history, les champs `createdAt`, `createdTime` et `timestamp` seront
      remplacés par le champ `created` qui renvoie l'heure de création au format UTC.
    </li>

    <li>
      Le champ `scheduleDate` ne renverra plus un Object mais une String contenant l'heure de planification
      au format UTC.
    </li>

    <li>
      Le champ non documenté `created_date` sur /history sera supprimé. Utilisez `created` à la place.
    </li>
  </ul>
</Update>

<Update label="22 avril 2022">
  <ul class="custom-bullets">
    <li>
      Les statistiques sur une [publication Facebook](/apis/analytics/post) renvoient `reactions` sous forme d'objet au
      format suivant.
    </li>
  </ul>
</Update>

<Update label="1er avril 2022">
  <ul class="custom-bullets">
    <li>
      Par défaut, history renverra les 20 dernières publications. Jusqu'à 500 peuvent être renvoyées avec le
      paramètre `lastRecords`.
    </li>
  </ul>
</Update>