Passer au contenu principal
POST
Obtenez des analyses et des données démographiques sur le profil social d’un utilisateur, comme les impressions, les vues et les abonnés. Actuellement disponible pour Bluesky, Facebook Pages, Google My Business, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok, X/Twitter et YouTube.
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 (unique) de 3 secondes sur toutes les versions de la Graph API ; l’objet analytics Facebook ne retourne donc plus la famille pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*, pagePostsServedImpressionsOrganicUnique) ni pageVideoViewsUnique. Utilisez pageMediaView pour la portée (un successeur Total Unique Media Views est prévu). pagePostEngagements, pageVideoViews et pageVideoViewsPaid ne sont pas affectés. Référence : Modifications à venir de l’API — 15 juin 2026.
  • Les analyses des pages Facebook ne sont disponibles que pour les pages ayant 100 mentions J’aime ou plus, notamment les données démographiques. Facebook met généralement à jour ses métriques une fois toutes les 24 heures.
  • Instagram peut prendre jusqu’à 48 heures pour calculer les données d’analyse. Les analyses du nombre d’abonnés ne sont pas disponibles avec moins de 100 abonnés. Les métriques démographiques ne renvoient que les 45 meilleurs performeurs, seuls les spectateurs pour lesquels nous avons des données démographiques sont utilisés dans les calculs de métriques démographiques, et les données démographiques ne sont pas retournées si l’utilisateur Instagram a eu moins de 100 engagements au cours des 30 derniers jours.
  • Lors de la récupération des analyses sociales Instagram, les informations démographiques peuvent ne pas apparaître dans la réponse pour certaines métriques. Les informations démographiques apparaîtront lorsque les métriques ont plus de 100 personnes dans chaque catégorie. Veuillez consulter Avertissement sur les données démographiques d’Instagram Analytics pour plus d’informations.
  • LinkedIn prend en charge à la fois les analyses des pages d’entreprise et les analyses des profils personnels (membres). Pour les profils personnels, l’objet analytics inclut un followersCount cumulé, la croissance quotidienne des abonnés dans followersDaily[], ainsi que les métriques agrégées de publication (impressionCount, uniqueImpressionsCount, likeCount, commentCount, shareCount). Les totaux count LinkedIn sont à cohérence éventuelle, mais pas immédiate, et peuvent prendre jusqu’à 24 à 48 heures dans certains cas. Les shareCount, likeCount et commentCount agrégés pour les profils personnels sont fournis au mieux et peuvent différer légèrement des chiffres affichés dans l’interface LinkedIn.
  • 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.
  • Veuillez consulter le point de terminaison d’analyses de publication pour plus d’informations.

Paramètres d’en-tête

Paramètres du corps

platforms
array
requis
Plateformes de médias sociaux pour lesquelles obtenir des analyses. Accepte un tableau de chaînes avec les valeurs :
quarters
integer
Spécifie combien de trimestres de données historiques retourner. Un trimestre correspond à :
  • 85 jours pour Facebook
  • 90 jours pour Instagram, TikTok et YouTube
  • 90 jours pour Snapchat (plafonné à 1 trimestre / 90 jours max en raison des limitations de l’API Snapchat)
Disponible pour les plateformes Facebook, Instagram, Snapchat, TikTok et YouTube. Valeurs valides : 1 à 4. Seules les valeurs supérieures à 0 activent le filtrage par date.Filtrage par date (Instagram & TikTok) : Le filtrage par date est actif lorsque daily=true OU quarters > 0. Si ni daily ni quarters n’est fourni, les données de tous les temps sont retournées sans filtre de date appliqué.Remarque : quarters: 0 est désormais traité comme aucune plage de dates (données de tous les temps). Auparavant, quarters: 0 était traité comme quarters: 1.
daily
boolean
défaut:false
Lorsqu’il est défini sur true, retourne les données d’analyse sous forme de valeurs quotidiennes en série temporelle plutôt que sous forme de totaux agrégés. Cette option est uniquement disponible pour les plateformes Facebook, Instagram, Snapchat, TikTok et YouTube. En raison de la taille des données plus importante, l’utilisation de la compression est recommandée.Pour Instagram et TikTok, définir daily=true active également le filtrage par date avec une fenêtre de trimestres plus courte par défaut.Portée Instagram : Avec daily=true, la réponse Instagram retourne un objet reach imbriqué (contenant period et une série temporelle values) au lieu du champ scalaire reachCount retourné en mode non-daily.
period60Days
boolean
défaut:false
Pour les analyses TikTok, lorsqu’il est défini sur true, retourne uniquement les totaux agrégés sur 60 jours pour les commentaires, les partages et les vues (commentCountTotal, shareCountTotal, viewCountTotal). Cela offre des temps de réponse plus rapides par rapport à la récupération de l’historique complet des analyses. Remarque : n’utilisez pas ce paramètre avec daily=true car ils sont incompatibles.Important : depuis le 1er mars 2025, TikTok est passé à des totaux sur 60 jours. Depuis avril 2026, TikTok utilise un filtrage par date basé sur les trimestres — utilisez le paramètre quarters pour contrôler la fenêtre de dates (p. ex. quarters: 1 = 90 jours, quarters: 2 = 180 jours). Voir Modifications à venir pour plus de détails.
youtube
object
Options spécifiques à la plateforme pour les analyses YouTube.lifetime (booléen, par défaut : false) : Lorsqu’il est défini sur true, inclut lifetimeLikes dans la réponse — la somme des mentions J’aime sur toutes les vidéos publiques de la chaîne. Il est calculé en récupérant toutes les vidéos et en additionnant leurs nombres de mentions J’aime, ce qui peut prendre plus de temps pour les chaînes ayant beaucoup de vidéos.Seuil : Les chaînes de plus de 1 000 vidéos retourneront lifetimeLikes: null et un avertissement dans le tableau warnings de premier niveau. Cela empêche une utilisation excessive de l’API.Mise en cache : Par chaîne, avec des TTL plus courts pour les résultats non-succès afin que les nouvelles tentatives récupèrent rapidement les changements d’état :
  • Valeur lifetimeLikes réussie : 24 heures.
  • Abandon à 1 000 vidéos (avertissement code: 445) : 1 heure — assez court pour qu’une chaîne qui supprime des vidéos pour passer sous le seuil n’ait pas à attendre une journée entière pour obtenir une vraie valeur.
  • Pannes transitoires de l’API YouTube Data (avertissement code: 446) : non mis en cache — la requête suivante réessaie.
Remarque : Les vidéos supprimées ou privées sont exclues de la somme, de sorte que le total peut différer des « vraies » mentions J’aime cumulées pour les chaînes qui ont supprimé des vidéos.Exemple de requête :
userId
string
X/Twitter uniquement. Ce paramètre vous permet de récupérer les publications d’un utilisateur X/Twitter spécifique par son ID numérique, plutôt que depuis votre compte lié.Par exemple, pour obtenir toutes les publications du handle @Google, vous utiliseriez son userId numérique 20536157.Vous pouvez trouver l’userId numérique de n’importe quel utilisateur X/Twitter en utilisant le point de terminaison Brands Get User.Remarque : utilisez uniquement l’API KEY dans l’en-tête pour effectuer cette requête. N’incluez pas la Profile Key.
userName
string
X/Twitter uniquement. Ce paramètre vous permet de récupérer les publications d’un utilisateur X/Twitter spécifique par son handle, plutôt que depuis votre compte lié.Par exemple, pour obtenir toutes les publications du handle @Google.Remarque : utilisez uniquement l’API KEY dans l’en-tête pour effectuer cette requête. N’incluez pas la Profile Key.
Lorsque les métriques cumulatives (p. ex. abonnés, mentions J’aime) 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.LinkedIn reactions : La métrique cumulative reactions au niveau de la publication (un objet de décomptes de réactions par type) est soumise à ce backfill uniquement-si-vide. Lorsque LinkedIn limite le taux de récupération des réactions, la valeur est reportée depuis le dernier instantané réussi — et backfilledFrom est défini à l’horodatage de cet instantané — au lieu de revenir à vide.
Analyses LinkedIn personnelles (membre) — nouvelle liaison requise. Les profils LinkedIn personnels liés avant l’arrivée des analyses au niveau membre n’ont pas les portées d’analyse requises. Les requêtes d’analyses sociales 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.
warnings (tableau d’objets, champ optionnel de premier niveau) — Présent uniquement lorsque Ayrshare doit informer l’appelant d’une condition non fatale (p. ex. un calcul opt-in a été ignoré). Absent de la réponse quand il n’y a rien à signaler.Chaque entrée est un objet structuré, et non une chaîne libre :
ChampTypeDescription
actionstringLe contexte de l’opération qui a produit l’avertissement (p. ex. "analytics").
statusstringToujours "warning" pour les entrées du tableau warnings.
codenumberCode d’avertissement Ayrshare stable. Peut être utilisé pour matcher côté client.
messagestringDescription lisible par l’humain.
detailsstringContexte supplémentaire optionnel spécifique à cette instance d’avertissement.
Codes d’avertissement connus :
  • 445lifetimeLikes ignoré car la chaîne YouTube dépasse le seuil de 1 000 vidéos.
  • 446lifetimeLikes indisponible car l’API YouTube Data a retourné des erreurs pour la playlist des uploads ou pour tous les lots videos.list.