Passer au contenu principal
POST
Obtenez des analyses en temps réel telles que les mentions J’aime, les impressions, les vues et les réactions pour une publication envoyée via Ayrshare en utilisant l’ID de publication Ayrshare. Pour les analyses des publications provenant de l’extérieur d’Ayrshare, consultez Analytics par ID de publication social.
Facebook : certaines métriques de portée et de vidéo ont été retirées par Meta (15 juin 2026). Meta a supprimé les métriques Insights d’impression unique et de visionnage vidéo de 3 secondes sur toutes les versions de la Graph API ; l’objet analytics Facebook ne retourne donc plus impressionsUnique, impressionsFanUnique, impressionsOrganicUnique, impressionsPaidUnique ni videoViewsUnique. Utilisez mediaView pour la portée (un successeur Total Unique Media Views est prévu). Les autres champs couramment utilisés tels que reactionsByType et videoViews ne sont pas affectés. Référence : Modifications à venir de l’API — 15 juin 2026.

Informations supplémentaires

  • Les plateformes suivantes sont actuellement prises en charge : Bluesky, Facebook Pages, Instagram, X/Twitter, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok et YouTube.
  • Les nombres de commentaires Facebook et Instagram affichés dans l’API peuvent différer de ceux affichés dans les applications sociales. Cela se produit pour deux raisons : - Certains utilisateurs ont des paramètres de confidentialité qui masquent leurs commentaires aux non-amis ou aux utilisateurs sans connexions mutuelles. Ces commentaires privés sont toujours inclus dans le nombre total de commentaires. - Il peut y avoir des incohérences dans les données rapportées par Meta.
  • Instagram igReelsAggregatedAllPlaysCount et playsCount affichés dans l’API peuvent différer des nombres affichés dans les applications sociales. Cela peut se produire pour plusieurs raisons :
    • La publication a été promue. Seules les lectures organiques sont incluses dans la réponse de l’API.
    • Il peut y avoir des incohérences dans les données rapportées par Meta.
  • Les fils X/Twitter sont retournés sous forme de tableau d’objets, chaque objet correspondant à un Tweet du fil.
  • YouTube peut prendre 24 à 48 heures pour traiter les analyses des vidéos ayant peu de vues ou peu d’abonnés à la chaîne.
  • Analyses TikTok :
    • TikTok peut prendre 24 à 48 heures pour mettre à jour ses données d’analyse, telles que les vues de vidéos, les données démographiques, les mentions J’aime, les partages et les commentaires.
    • Pour accéder aux analyses TikTok, les propriétaires de compte doivent : 1. Publier au moins une vidéo. 2. Appuyer sur le bouton « Turn On » sur la page Analytics de leur application mobile TikTok. 3. Avoir 100 abonnés pour recevoir des informations supplémentaires sur les spectateurs et l’engagement du contenu.
    • TikTok ne renvoie pas d’analyses de publication si le média contient du matériel protégé par des droits d’auteur ou a été signalé pour une violation de droits d’auteur. Les exemples de matériel protégé par des droits d’auteur peuvent inclure l’audio des reels (TikTok mettra ces vidéos en sourdine). Vous pouvez vérifier dans l’application TikTok sous Activity -> System Notifications.
    • Certains champs d’analyse TikTok peuvent être indisponibles si la vidéo est inactive depuis plus de 7 jours. Pour récupérer ces données, générez une nouvelle activité sur la vidéo (visionnage, mention J’aime, commentaire ou partage) et réessayez après 24 à 48 heures. Si une vidéo n’est pas retournée dans la réponse, c’est probablement parce qu’elle a été filtrée en raison de violations, telles qu’une violation des droits d’auteur musicaux. Ces champs comprennent :
      • reach
      • fullVideoWatchedRate
      • totalTimeWatched
      • averageTimeWatched
      • impressionSources
      • audienceCountries
  • Les profils LinkedIn personnels (membres) renvoient désormais une matrice d’analyses de publication étendue. Les métriques disponibles pour les membres sont :
    • impressionCount — Impressions sur la publication
    • uniqueImpressionsCount — Membres uniques atteints (LinkedIn MEMBERS_REACHED)
    • likeCount — Nombre de réactions
    • commentCount — Nombre de commentaires
    • shareCount — Republications de la publication
    • engagement — Clics, mentions J’aime, commentaires et partages organiques par rapport aux impressions
    • reactions — Répartition des réactions par type (lorsqu’il y a des réactions)
    • Pour les publications vidéo : videoViews, videoViewers et videoWatchTimeMs
    Les métriques vidéo ne sont retournées que pour les publications vidéo et sont indisponibles plus d’un an après la création de la publication.
  • Les insights des stories Instagram ne sont disponibles que pendant 24 heures, que les stories soient archivées ou en vedette. Remarque :
    • Les métriques de média de story dont les valeurs sont inférieures à 5 sont retournées comme 0.
    • Pour les stories créées par des utilisateurs en Europe et au Japon, la métrique replies retourne une valeur de 0.
  • Les analyses des stories Facebook ne sont pas disponibles.
  • Les données d’analyse Pinterest (impressions, abonnés et clics) deviennent disponibles après 24 à 72 heures.
  • Pour les YouTube Shorts, les vues retourneront le nombre de fois qu’un Short commence à être lu ou relu, sans exigence de durée de visionnage minimale.

Paramètres d’en-tête

Paramètres du corps

id
string
requis
ID de publication Ayrshare retourné par le point de terminaison /post. Il s’agit de l’id Ayrshare de premier niveau retourné, et non des IDs de publication sociaux dans postIds.
platforms
array
Tableau de chaînes des plateformes pour lesquelles récupérer les analyses. Accepte un tableau de chaînes avec les valeurs :
Si platforms n’est pas inclus, les analyses seront retournées pour tous les réseaux sociaux vers lesquels la publication a été envoyée.
Lorsque les métriques cumulatives (p. ex. mentions J’aime, commentaires, vues) sont temporairement indisponibles depuis le réseau social, l’API les complète automatiquement à partir des données stockées. Deux champs optionnels peuvent apparaître dans l’objet analytics par plateforme :
  • backfilledFrom (string, ISO 8601) — Présent lorsqu’une ou plusieurs métriques cumulatives ont été substituées à partir des données stockées. L’horodatage indique la dernière mise à jour des données stockées.
  • recoveredFrom (string, ISO 8601) — Présent lorsque la réponse d’analyse entière a été récupérée à partir des données stockées en raison d’une panne complète de l’API. L’horodatage indique la dernière mise à jour des données stockées.
Les données stockées de plus de 4 jours sont considérées comme obsolètes et ne seront pas utilisées pour le backfill ou la récupération.
Analyses LinkedIn personnelles (membre) — nouvelle liaison requise. Les profils LinkedIn personnels liés avant l’arrivée des analyses de publication au niveau membre n’ont pas les portées d’analyse requises. Les requêtes d’analyse pour ces profils retournent le code d’erreur 475 (« re-link your LinkedIn profile to enable analytics »). Le propriétaire du compte doit relier son profil LinkedIn sur la page Social Accounts pour accorder les nouvelles portées. Prévoyez quelques minutes après la nouvelle liaison pour que le code 475 disparaisse (Ayrshare et LinkedIn mettent brièvement en cache l’état des permissions, généralement ~5-10 minutes). La publication n’est pas affectée.Les décomptes des publications au niveau membre LinkedIn sont fournis au mieux : les totaux agrégés shareCount (RESHARE), likeCount (REACTION) et commentCount (COMMENT) peuvent différer légèrement des chiffres affichés dans l’interface LinkedIn.