Skip to main content
POST
/apis/analytics/social-by-id est cette page de documentation, et non une route API. Envoyez les requêtes pour une publication et les requêtes par lot à POST /analytics/post avec une seule valeur dans platforms et searchPlatformId: true : {"id":"SOCIAL_POST_ID","platforms":["twitter"],"searchPlatformId":true} pour une publication, ou {"postIds":["ID_1","ID_2"],"platforms":["twitter"],"searchPlatformId":true} pour un maximum de 100 publications.
Récupérez les analyses des publications qui n’ont pas été créées via Ayrshare en fournissant l’ID de publication social de bas niveau. Cet ID est retourné dans le champ postIds du point de terminaison /post. Le compte lié doit être le propriétaire de la publication pour récupérer les analyses (exception : YouTube ; voir ci-dessous). Plateformes prises en charge : Facebook, Instagram, LinkedIn, Threads, TikTok, Twitter et YouTube.
  • L’appel est le même que celui du point de terminaison Analytics d’une publication. La différence clé est que vous utilisez l’ID de publication retourné par le réseau social au lieu de l’ID Ayrshare. Incluez également le paramètre searchPlatformId: true pour indiquer au point de terminaison que vous recherchez par l’ID de publication social.
  • Utilisez le point de terminaison Get All Post History pour récupérer les publications et les IDs provenant de l’extérieur d’Ayrshare, trouvés dans le champ id.
  • Recommandé uniquement pour les publications non envoyées via Ayrshare. Pour les publications envoyées via Ayrshare, utilisez le point de terminaison analytics.
  • Les analyses des publications Instagram qui ont été publiées avant que le compte utilisateur ne soit converti en compte professionnel depuis un compte personnel ont des analyses limitées.
  • Lors de la récupération des analyses YouTube pour une publication qui n’appartient pas à votre chaîne en utilisant la méthode d’ID social, l’API retournera des métadonnées descriptives sur le contenu tout en affichant des zéros pour toutes les métriques numériques. Les informations descriptives telles que le titre, la description, les tags, le titre de la chaîne, le statut de confidentialité et les URLs des vignettes seront correctement renseignées, fournissant un contexte sur le contenu vidéo. Cependant, toutes les métriques de performance numériques, y compris les vues, les mentions J’aime, les commentaires, les partages, les variations d’abonnés, la durée de visionnage et les ajouts aux playlists, retourneront des valeurs nulles.
  • Lorsque vous utilisez postIds pour des fils X/Twitter, l’ID de publication social de chaque tweet doit être fourni individuellement ; les tweets du fil ne sont pas automatiquement inclus lors d’une requête sur la publication parente.

​
Paramètres d’en-tête

​
Paramètres du corps

Soit id, soit postIds doit être fourni. Utilisez id pour une seule publication ou postIds pour récupérer les analyses de plusieurs publications dans une seule requête.
​
string
ID de publication social retourné par le point de terminaison /post. Il s’agit du champ id pour un réseau social individuel trouvé dans le tableau postIds. Soit id, soit postIds est requis.
​
array
Tableau d’IDs de publication sociaux pour récupérer les analyses de plusieurs publications dans une seule requête. Maximum de 100 IDs autorisés. Soit id, soit postIds est requis.
​
array
requis
Tableau de chaînes des plateformes pour lesquelles récupérer les analyses. Une seule valeur est autorisée.Valeurs disponibles :
​
boolean
défaut:false
requis
Définissez sur true pour effectuer la recherche par l’ID de publication social.
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.
Une réponse avec code: 186 signifie que l’ID de publication social est introuvable pour le compte et la plateforme sélectionnés. L’URL du message renvoie à cette page de documentation ; elle ne désigne pas un autre endpoint API. Corrigez la requête et réessayez POST /analytics/post avec l’un des formats ci-dessus.