Skip to main content
GET
Obtenez les commentaires d’une publication en utilisant l’ID de publication Ayrshare, l’ID de publication social, l’ID de commentaire Ayrshare ou l’ID de commentaire social avec l’API Comments. Veuillez consulter la Vue d’ensemble des commentaires pour plus d’informations sur les différents types d’identifiants.
Si vous utilisez l’ID de publication Ayrshare, aucun paramètre de requête n’est nécessaire.

​
Détails supplémentaires des commentaires

  • Les données de commentaires sont mises à jour toutes les 10 minutes pour toutes les plateformes, à l’exception de X. En raison des restrictions imposées par l’API de X, les données de commentaires pour X sont actualisées à l’aide d’une stratégie de backoff exponentiel, ce qui signifie que les intervalles entre les mises à jour augmentent progressivement au fil du temps.
  • Dans la réponse Facebook, les réponses de commentaires aux réponses ont toujours le même parent.id.
  • Récupérez les réponses LinkedIn aux commentaires en définissant les paramètres de requête "commentId": true et "searchPlatformId": true et en fournissant l’ID de commentaire social dans le paramètre de chemin.
  • Facebook et Instagram retournent jusqu’aux 1 000 commentaires les plus récents sur une publication. Veuillez nous contacter concernant des limites plus élevées sur le plan Enterprise.
  • Pour une publication TikTok encore en cours de traitement (son id est "pending"), get-comments retourne une erreur claire « still processing » (code: 288, HTTP 400) plutôt qu’un échec générique. Réessayez une fois que le webhook tikTokPublished se déclenche ou que /history affiche l’ID vidéo résolu.

​
Lectures multiplateformes & succès partiel

Lorsque vous demandez des commentaires avec l’Ayrshare Post ID, la publication peut couvrir plusieurs plateformes. Ayrshare éclate une requête (« tronçon ») par plateforme et renvoie un succès partiel si certains tronçons réussissent et que d’autres échouent — les données de commentaires des plateformes saines sont toujours retournées, et chaque tronçon en échec est énuméré dans un tableau errors[] de premier niveau.
  • Certaines plateformes réussissent, d’autres échouent : la réponse est HTTP 200 avec status: “partial”. Les blocs des plateformes saines sont retournés comme d’habitude, et un tableau errors[] de premier niveau liste chaque tronçon en échec avec son platform, status, code, message et id.
  • Toutes les plateformes échouent : la réponse a status: “error” et le tableau errors[] complet. Le statut HTTP est dérivé du code d’erreur représentatif de premier niveau. Le code 485 est associé à HTTP 404 ; les autres codes représentatifs utilisent leurs propres correspondances.
  • Toutes les plateformes réussissent : la réponse est inchangée — HTTP 200, status: “success”, et aucune clé errors[].
Changement de comportement — inspectez errors[], ne conditionnez pas sur le statut HTTP. Comme une lecture multiplateforme dont un tronçon échoue renvoie désormais HTTP 200 au lieu de faire s’effondrer la réponse entière en erreur, les intégrateurs doivent toujours vérifier la présence d’un tableau errors[] de premier niveau pour détecter les échecs par plateforme, plutôt que de se fier uniquement au code de statut HTTP.

​
Commentaires de Story Instagram / Facebook expirés ou indisponibles

Un tronçon de commentaires de Story Instagram ou Facebook qui est expiré ou indisponible — dont les commentaires ne peuvent donc pas être récupérés — apparaît dans errors[] avec le code 485. Un message Instagram représentatif est « Instagram Story expired or unavailable — comments/insights cannot be retrieved. » Si une autre plateforme réussit, ses commentaires sont tout de même retournés et la réponse globale est HTTP 200. Pour une réponse entièrement en échec, le code représentatif 485 est associé à HTTP 404 ; les autres codes représentatifs utilisent leurs propres correspondances. Faites correspondre sur le code (485), et non sur le texte exact du message.

​
Exemple : réponse de succès partiel

200: Succès partiel

​
Paramètres d’en-tête

​
Paramètres de chemin

​
string
requis
ID de publication Ayrshare, ID de publication social ou ID de commentaire social.

​
Paramètres de requête

​
boolean
défaut:false
Si vous obtenez des commentaires sur une publication publiée via Ayrshare et utilisez l’ID de publication Ayrshare, n’incluez pas ce champ - il vaut false par défaut. Si vous obtenez des commentaires en utilisant l’ID de publication social ou l’ID de commentaire social, qui est l’ID généré par les réseaux sociaux, définissez sur true.
​
boolean
défaut:false
Si vous obtenez des commentaires en utilisant l’ID de commentaire social, qui est l’ID de commentaire généré par les réseaux sociaux, définissez sur true.Si vous obtenez des commentaires en utilisant l’ID de publication Ayrshare ou l’ID de publication social, n’incluez pas ce champ - il vaut false par défaut.
Si vous utilisez le paramètre de requête commentId, vous devez également définir searchPlatformId sur true.
​
string
Requis si searchPlatformId ou commentId vaut true.Quand l’utiliser :
  • Si vous utilisez l’ID de publication social et le champ "searchPlatformId": true. Plateformes prises en charge : bluesky, facebook, instagram, linkedin, threads, tiktok, twitter, youtube.
  • Si vous utilisez l’ID de commentaire social et les champs "searchPlatformId": true et "commentId": true. Plateformes prises en charge : facebook, instagram, linkedin.
  • Si vous utilisez l’ID de publication Ayrshare, n’incluez pas ce champ - les commentaires seront retournés depuis toutes les plateformes où la publication d’origine a été publiée.

​
Exemples de requêtes GET Comment