Listings APIListings API
Se connecter
GET/api/v4/social/posts/{postId}/insights

Obtenir les statistiques et commentaires d’une publication

Renvoie les données d'engagement propres à la plateforme et les commentaires d'une publication publiée sur un canal connecté.

Nécessite une clé API. Consultez Authentification pour le format de l’en-tête et la rotation des clés.

Paramètres

Chemin

NomTypeObligatoireDescription
postIdstringobligatoirePost UUID, the `socialPostId` returned by POST /social/posts.

Chaîne de requête

NomTypeObligatoireDescriptionPar défaut
socialConnectedChannelIdstringobligatoireUUID of the connection to read insights for, the `id` of a row from the brand's connections list. Insights are per channel, so this is required even when the post targeted one platform. Note the name: this endpoint takes `socialConnectedChannelId`, while disconnect takes `socialProfileConnectedChannelId` for the same ID.—

Réponses

200The platform's engagement payload and comments. Both fields are JSON strings whose keys are set by the platform, not by Listings API: parse them before reading.
Response
{  "data": {    "getPostInsightsAndCommentsForSocialChannel": {      "insights": "{\"impressions\": 4820, \"reach\": 3915, \"likes\": 212, \"comments\": 18, \"saved\": 44, \"shares\": 9, \"profile_visits\": 61}",      "comments": "[{\"id\": \"17912345678901234\", \"username\": \"marta.builds\", \"text\": \"That oak finish is beautiful. Do you ship?\", \"like_count\": 3, \"timestamp\": \"2026-10-02T15:12:44+0000\"}, {\"id\": \"17912345678905678\", \"username\": \"eastsidehome\", \"text\": \"Stopping by Saturday!\", \"like_count\": 0, \"timestamp\": \"2026-10-02T18:40:02+0000\"}]"    }  }}
401Unauthenticated, missing or invalid API key.
404No post with that ID on this account, or the connection does not belong to the post's brand (`SY95052`).

Renvoie les informations fournies par la plateforme sur une publication publiée sur un canal : ses indicateurs d'engagement et les commentaires qui y ont été laissés.

Cas d'utilisation : un panneau d'engagement par publication. Lorsqu'un client ouvre une publication publiée dans votre interface, appelez GET /social/posts/{postId} pour obtenir la liste des canaux, puis appelez cet endpoint une fois par canal avec le id de ce canal. Analysez insights, affichez les indicateurs que vous reconnaissez et ignorez les autres — ainsi, l'ajout d'un champ par une plateforme ne perturbera jamais votre page.

Cas d'utilisation : faire ressortir les commentaires qui nécessitent une réponse. Interrogez régulièrement cet endpoint pour les publications récemment publiées et acheminez les nouvelles entrées du tableau comments obtenu après analyse vers votre propre boîte de réception. Notez que cet endpoint est en lecture seule : la réponse à un commentaire se fait sur la plateforme, pas via la Listings API.

Remarques.

  • socialConnectedChannelId est obligatoire et correspond au id de la connexion provenant des connexions de la marque — pas au referenceId de la plateforme. Les statistiques portent toujours sur un seul canal, car les chiffres proviennent de l'API de cette plateforme.
  • Le canal doit appartenir à la même marque que la publication. L'association d'une publication à la connexion d'une autre marque renvoie SY95052.
  • Seules les publications publiées disposent de statistiques. Une publication qui est encore SCHEDULED, ou dont la publication a échoué sur ce canal, renvoie des données vides plutôt qu'une erreur ; vérifiez donc connectedChannels[].status sur la publication avant de tirer des conclusions.
  • La fraîcheur des indicateurs dépend de la plateforme, ce qui, pour la plupart des plateformes, implique un décalage de quelques minutes à quelques heures après la publication. Interrogez cet endpoint à intervalles réguliers plutôt que de vous attendre à obtenir des chiffres immédiatement après le passage de connectedChannels[].status à SUCCESS.
  • Le volume de commentaires est limité à ce que la plateforme renvoie sur une seule page ; cet endpoint ne poursuit pas la pagination au-delà.
Request
curl -X GET 'https://listingsapi.com/api/v4/social/posts/<postId>/insights?socialConnectedChannelId=<socialConnectedChannelId>' \  -H "Authorization: API $LISTINGSAPI_KEY"
Run in playground