Passer au contenu principal
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 pour toutes les nouvelles fonctionnalités.
​
15 juin 2026
  • 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 pour plus de détails.
    • GET analytics/post ne renvoie plus les champs Facebook suivants :
      • impressionsUnique → migrez vers mediaView
      • impressionsFanUnique → migrez vers mediaView
      • impressionsOrganicUnique → migrez vers mediaView
      • impressionsPaidUnique → migrez vers mediaViewIsFromAds
      • videoViewsUnique → utilisez videoViews pour les vues non uniques de 3 secondes
      • Les familles totalVideoViews*Unique et totalVideoImpressions* (par exemple totalVideoViewsOrganicUnique, totalVideoViewsPaidUnique, totalVideoViewsUnique)
    • GET analytics/social ne renvoie plus les champs Facebook suivants :
      • La famille pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*) → migrez vers pageMediaView
      • pagePostsServedImpressionsOrganicUnique → migrez vers pageMediaView
      • pageVideoViewsUnique → utilisez pageVideoViews pour les vues non uniques de 3 secondes
    • 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.
​
11 mai 2026
  • 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 pour plus de détails.
​
9 avril 2026
  • Les statistiques vides renvoient l’erreur 187 : demander Social Analytics ou Post Analytics 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.
​
31 mars 2026
  • 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 pour les instructions.
  • 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.
  • 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.).
​
14 novembre 2025
  • À partir du 14 novembre 2025, Facebook dépréciera les champs suivants pour GET analytics/social :
    • pageFans
    • pageFansCity
    • pageFansLocale
    • pageFansCountry
    • pageFansAdds
    • pageFanAddsUnique
    • pageFanRemoves
    • pageFanRemovesUnique
    • pageImpressions → migrez vers pageMediaView
    • pageImpressionsPaidUnique → migrez vers pageMediaViewIsFromAds
    • pageImpressionsUnique
    • pageImpressionsViral
    • pageImpressionsViralUnique
    • pageImpressionsPaid → migrez vers pageMediaViewIsFromAds
  • À partir du 14 novembre 2025, Facebook dépréciera les champs suivants pour GET analytics/post :
    • 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).
    • postImpressionsUnique (Reels) → utilisez blueReelsPlayCount pour le nombre de lectures de reel ou postVideoViewTime pour le temps total de visionnage.
​
1er septembre 2025
  • À partir du 1er septembre 2025, le point de terminaison 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.
​
1er juin 2025
  • Le point de terminaison 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 :
    • followersCount
    • followingCount
    • tweetCount
    • listedCount
    • mediaCount
  • Facebook dépréciera les champs suivants pour GET analytics/social :
    • pageVideoViews10S
    • pageVideoViews10SAutoplayed
    • pageVideoViews10SClickToPlay
    • pageVideoViews10SOrganic
    • pageVideoViews10SPaid
    • pageVideoViews10SRepeat
    • pageVideoViews10SUnique
​
7 mai 2025
  • 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.
​
20 avril 2025
​
1er mars 2025
Le point de terminaison get comments pour TikTok standardisera les noms de champs pour correspondre aux autres réseaux sociaux.
  • Le champ replyList sera renommé en replies et profileImage sera renommé en profileImageUrl.
  • Les deux nouveaux noms de champs sont déjà disponibles et peuvent être utilisés dans votre intégration.
  • TikTok a les mises à jour suivantes :
    • Point de terminaison social analytics : 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.
    • Points de terminaison history platform et post analytics : 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.
​
1er février 2025
Le point de terminaison /user change sa façon de signaler l’utilisation de l’API :
  • Le champ monthlyApiCalls sera étendu pour compter tous les appels API (publications, commentaires, statistiques, etc.).
  • Pour les décomptes spécifiques aux publications, utilisez le nouveau champ monthlyPostCount.
  • Le champ monthlyApiCallsQuota sera déprécié et remplacé par le nouveau champ monthlyPostQuota.
​
5 janvier 2025
​
15 décembre 2024
  • 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 comment utiliser correctement une Profile Key.
​
15 novembre 2024
  • 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.
  • 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.
  • 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.
​
7 octobre 2024
  • Le point de terminaison media ne renverra plus url_1080. Si vous devez redimensionner une image, veuillez consulter le point de terminaison resize.
​
16 septembre 2024
​
3 juin 2024
  • Le nouveau système de raccourcissement de liens 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.
  • 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.
​
22 avril 2024
  • Meta dépréciera son API Facebook Groups. Veuillez consulter l’annonce.
​
16 avril 2024
  • 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.
​
1er avril 2024
  • La réponse par défaut de Répondre à un commentaire avec un ID de commentaire 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.
​
25 janvier 2024
​
8 décembre 2023
  • 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.
  • 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.
  • 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.
  • La documentation delete comment a été corrigée pour s’aligner sur le retour correct.
  • Le champ TikTok commentId sera remplacé par le champ id pour s’aligner sur le format standard de suppression de commentaire.
  • 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 :
​
18 octobre 2023
​
30 mai 2023
  • 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.
​
8 mai 2023
  • Nous sommes ravis de lancer la publication directe 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.
  • Nous présentons également l’ajout, la récupération et la suppression de commentaires TikTok + les données statistiques démographiques.
  • 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.
​
17 février 2023
  • 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.
​
1er octobre 2022
  • Les champs descriptions, text, message de Get All Posts sont standardisés vers le champ post.
​
12 septembre 2022
  • Champs TikTok dépréciés : shareUrl. Utilisez postUrl à la place.
​
17 juin 2022
  • 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.
  • Le champ scheduleDate ne renverra plus un Object mais une String contenant l’heure de planification au format UTC.
  • Le champ non documenté created_date sur /history sera supprimé. Utilisez created à la place.
​
22 avril 2022
  • Les statistiques sur une publication Facebook renvoient reactions sous forme d’objet au format suivant.
​
1er avril 2022
  • Par défaut, history renverra les 20 dernières publications. Jusqu’à 500 peuvent être renvoyées avec le paramètre lastRecords.