Statistiques par publication

Permission: analytics.read. Voir Rôles et permissions.

Les statistiques par publication répondent à « comment cette publication s'en est sortie » et « quelles publications ont le mieux marché ». Elles couvrent les publications publiées via AdaptlyPost et les publications découvertes sur les comptes connectés, donc une publication faite depuis l'application native apparaît quand même avec ses chiffres.

Il s'agit de performance, pas de livraison. Résultats de publication vous indique si une publication a atteint chaque plateforme ; cet endpoint vous indique ce qui s'est passé une fois publiée.

GET /api/v1/analytics/posts

GET /api/v1/analytics/posts?from=2026-08-01&to=2026-08-31&sortBy=VIEWS&page=1&limit=20

Paramètre	Description
from, to	La période, au format ISO 8601. Les publications sont sélectionnées selon leur date de publication. Obligatoire
platforms	Limite aux plateformes indiquées. Répétez la clé pour chaque valeur
connectionIds	Limite aux comptes indiqués, par leur `id` dans Comptes sociaux. Répétez la clé pour chaque valeur
sortBy	`VIEWS`, `LIKES`, `COMMENTS`, `SHARES`, `SAVES`, `CLICKS`, `IMPRESSIONS`, `ENGAGEMENT_RATE` ou `PUBLISHED_AT` (par défaut). Ordre décroissant
page	Numéro de page, à partir de 1
limit	Publications par page, de 1 à 100, 20 par défaut

{
  "posts": [
    {
      "id": "ap_01j9xk4",
      "postId": "cmm0z0k3q0000i0r5mxn0hfhs",
      "postPlatformId": "cmm0z0k3u0001i0r5dlbfa440",
      "platform": "INSTAGRAM",
      "connectionId": "conn_ig_001",
      "publishedAt": "2026-08-14T10:00:12.000Z",
      "title": "Plan a week of posts in one sitting",
      "thumbnailUrl": "https://cdn.adaptlypost.com/...",
      "permalink": "https://www.instagram.com/p/...",
      "accountName": "adaptlypost",
      "metrics": {
        "views": 9120,
        "likes": 410,
        "comments": 38,
        "shares": 22,
        "saves": 61,
        "clicks": null,
        "impressions": 10230,
        "reach": 8540,
        "engagementRate": 5.15
      }
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 20,
  "hasMore": true
}

Champ	Description
id	Identifiant de l'enregistrement de statistiques. Le seul identifiant que possède chaque publication suivie
postId	L'identifiant de publication AdaptlyPost, utilisable avec Obtenir un post. Null pour une publication découverte sur le compte
postPlatformId	Le `platformId` provenant de Résultats de publication. Null pour les publications découvertes
connectionId	Le compte auquel appartient la publication : son `id` dans Comptes sociaux
accountName	Nom affiché de ce compte, sur toutes les plateformes
permalink	URL publique de la publication sur la plateforme, quand elle est connue
metrics	Derniers compteurs capturés. Une statistique que la plateforme ne fournit pas vaut null

Les publications de la fiche d'établissement Google sont listées avec des métriques null : la fiche d'établissement Google ne donne que les impressions de l'établissement, pas par publication.

GET /api/v1/analytics/top-posts

GET /api/v1/analytics/top-posts?from=2026-08-01&to=2026-08-31&sortBy=ENGAGEMENT_RATE&limit=5

Les mêmes lignes sans pagination : les limit meilleures publications (1 à 50, 10 par défaut) triées par sortBy (par défaut VIEWS). Renvoie { "posts": [...] }. Il accepte les mêmes filtres platforms et connectionIds.

GET /api/v1/analytics/discovered-posts

GET /api/v1/analytics/discovered-posts?from=2026-08-01&to=2026-08-31&limit=200

Publications trouvées sur les comptes connectés qu'AdaptlyPost n'a pas publiées, pour un calendrier en lecture seule. Leurs statistiques se trouvent dans /analytics/posts ; cet endpoint renvoie la publication elle-même.

{
  "posts": [
    {
      "id": "ap_01j9xk9",
      "platform": "TIKTOK",
      "connectionId": "conn_tt_001",
      "publishedAt": "2026-08-20T17:30:00.000Z",
      "text": "Behind the scenes of our launch week",
      "thumbnailUrl": "https://cdn.adaptlypost.com/...",
      "permalink": "https://www.tiktok.com/@adaptlypost/video/...",
      "accountName": "adaptlypost"
    }
  ]
}

limit accepte de 1 à 1000, avec 200 par défaut. Il se filtre de la même façon avec platforms et connectionIds.

Jusqu'où remonter

Connecter un compte importe ses publications des 180 derniers jours, et les statistiques sont conservées ensuite tant que le compte reste connecté. Une publication continue d'être actualisée pendant 180 jours après sa parution, puis garde ses derniers chiffres. Certaines plateformes exposent moins d'historique pour un compte donné ; Synchronisation des statistiques indique l'horizon exact par compte.