Synupv1
Créer une clé
v1Ressources/Posts/getObtenir les statistiques d'un post

Obtenir les statistiques d'un post

Renvoie une synthèse des statistiques d'engagement — totaux résumés, répartition par plateforme, séries de tendance et posts les plus performants — à travers les connexions de plateforme de niveau marque d'un client.

get/api/v1/posts/analytics
posts:read
Paramètres de requête
clientIdstringobligatoire
Le client à synthétiser. Obligatoire.
fromstringfacultatif
Début de la période de reporting. Par défaut il y a 30 jours.
tostringfacultatif
Fin de la période de reporting. Par défaut maintenant.
Réponse
dataobjectfacultatif
summaryobjectfacultatif
Totaux d'engagement pour la période en cours.
totalPostsnumberfacultatif
Nombre de posts pour cette période.
totalViewsnumberfacultatif
Total des vues pour cette période.
totalReactionsnumberfacultatif
Total des réactions pour cette période.
totalSharesnumberfacultatif
Total des partages pour cette période.
totalCommentsnumberfacultatif
Total des commentaires pour cette période.
periodDaysnumberfacultatif
Durée de la période de reporting, en jours.
prevSummaryobjectfacultatif
Totaux d'engagement pour la période précédente de durée équivalente, pour comparaison de variation.
totalPostsnumberfacultatif
Nombre de posts pour cette période.
totalViewsnumberfacultatif
Total des vues pour cette période.
totalReactionsnumberfacultatif
Total des réactions pour cette période.
totalSharesnumberfacultatif
Total des partages pour cette période.
totalCommentsnumberfacultatif
Total des commentaires pour cette période.
byPlatformarray of objectfacultatif
Totaux d'engagement ventilés par plateforme pour cette période.
platformstringfacultatif
La plateforme concernée par cette ligne.
labelstringfacultatif
Nom d'affichage de la plateforme.
totalPostsnumberfacultatif
Nombre de posts pour cette période.
totalViewsnumberfacultatif
Total des vues pour cette période.
totalReactionsnumberfacultatif
Total des réactions pour cette période.
totalSharesnumberfacultatif
Total des partages pour cette période.
totalCommentsnumberfacultatif
Total des commentaires pour cette période.
prevByPlatformarray of objectfacultatif
Totaux d'engagement ventilés par plateforme pour la période précédente.
platformstringfacultatif
La plateforme concernée par cette ligne.
labelstringfacultatif
Nom d'affichage de la plateforme.
totalPostsnumberfacultatif
Nombre de posts pour cette période.
totalViewsnumberfacultatif
Total des vues pour cette période.
totalReactionsnumberfacultatif
Total des réactions pour cette période.
totalSharesnumberfacultatif
Total des partages pour cette période.
totalCommentsnumberfacultatif
Total des commentaires pour cette période.
trendobjectfacultatif
Nombre quotidien de vues par plateforme sur la période.
datesarray of stringfacultatif
Les dates couvertes par cette tendance, au format YYYY-MM-DD.
seriesarray of objectfacultatif
Une entrée par plateforme.
platformstringfacultatif
La plateforme concernée par cette ligne.
labelstringfacultatif
Nom d'affichage de la plateforme.
valuesarray of numberfacultatif
Une valeur par date dans dates, dans le même ordre.
engagementTrendobjectfacultatif
Vues, réactions, partages, commentaires et portée quotidiens par plateforme sur la période.
datesarray of stringfacultatif
Les dates couvertes par cette tendance, au format YYYY-MM-DD.
seriesarray of objectfacultatif
Une entrée par plateforme.
platformstringfacultatif
La plateforme concernée par cette ligne.
labelstringfacultatif
Nom d'affichage de la plateforme.
viewsarray of numberfacultatif
reactionsarray of numberfacultatif
sharesarray of numberfacultatif
commentsarray of numberfacultatif
reacharray of numberfacultatif
Valeurs de portée quotidiennes, dans le même ordre que dates.
postsTrendobjectfacultatif
Nombre quotidien de soumissions de posts par plateforme sur la période.
datesarray of stringfacultatif
Les dates couvertes par cette tendance, au format YYYY-MM-DD.
seriesarray of objectfacultatif
Une entrée par plateforme.
platformstringfacultatif
La plateforme concernée par cette ligne.
labelstringfacultatif
Nom d'affichage de la plateforme.
valuesarray of numberfacultatif
Une valeur par date dans dates, dans le même ordre.
allPostsarray of objectfacultatif
Les soumissions individuelles à partir desquelles cette synthèse est construite, triées par vues.
submissionIdstringfacultatif
Identifiant unique de la soumission à la plateforme.
platformstringfacultatif
La plateforme concernée par cette ligne.
platformPostIdstringfacultatif
L'identifiant propre à la plateforme pour le post publié, ou null.
postLinkstringfacultatif
URL publique du post publié sur cette plateforme, ou null.
publishedAtstringfacultatif
Date de publication de cette soumission, au format horodatage ISO 8601, ou null.
contentPreviewstringfacultatif
Le nom du post, pour l'affichage.
totalViewsnumberfacultatif
Total des vues pour cette période.
totalReactionsnumberfacultatif
Total des réactions pour cette période.
totalSharesnumberfacultatif
Total des partages pour cette période.
totalCommentsnumberfacultatif
Total des commentaires pour cette période.
totalReachnumberfacultatif
Portée totale pour cette soumission.
engRatenumberfacultatif
Taux d'engagement — réactions plus partages plus commentaires, en pourcentage des vues — ou null s'il n'y a pas encore de vues.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/posts/analytics
Votre clé API
clientId *
from
to
{
  "data": {
    "summary": {
      "totalPosts": 18,
      "totalViews": 5400,
      "totalReactions": 320,
      "totalShares": 44,
      "totalComments": 61,
      "periodDays": 30
    },
    "prevSummary": {
      "totalPosts": 14,
      "totalViews": 4100,
      "totalReactions": 260,
      "totalShares": 30,
      "totalComments": 48
    },
    "byPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 10,
        "totalViews": 3200,
        "totalReactions": 210,
        "totalShares": 30,
        "totalComments": 40
      },
      {
        "platform": "instagram",
        "label": "Instagram",
        "totalPosts": 8,
        "totalViews": 2200,
        "totalReactions": 110,
        "totalShares": 14,
        "totalComments": 21
      }
    ],
    "prevByPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 8,
        "totalViews": 2500,
        "totalReactions": 170,
        "totalShares": 20,
        "totalComments": 32
      }
    ],
    "trend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            4,
            6
          ]
        }
      ]
    },
    "engagementTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "views": [
            180,
            210
          ],
          "reactions": [
            12,
            15
          ],
          "shares": [
            2,
            3
          ],
          "comments": [
            4,
            5
          ],
          "reach": [
            900,
            1100
          ]
        }
      ]
    },
    "postsTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            1,
            2
          ]
        }
      ]
    },
    "allPosts": [
      {
        "submissionId": "cm_sub_xyz789",
        "platform": "facebook",
        "platformPostId": "1234567890",
        "postLink": "https://www.facebook.com/1234567890",
        "publishedAt": "2026-01-16T14:00:00.000Z",
        "contentPreview": "Join us this weekend for our fall special — 20% off all services!",
        "totalViews": 890,
        "totalReactions": 42,
        "totalShares": 6,
        "totalComments": 9,
        "totalReach": 1450,
        "engRate": 0.064
      }
    ]
  }
}