Statistiques par publication
Vues, mentions j'aime, commentaires, partages, enregistrements, portée et engagement par publication pour chaque publication parue pendant une période, triables selon n'importe quelle statistique, ainsi que les publications qu'AdaptlyPost a trouvées sur vos comptes sans les avoir publiées.
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 |
| 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",
"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 |
| 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 |
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": [...] }.
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",
"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.
Jusqu'où remonter
Rien de publié il y a plus de 180 jours n'apparaît, sur aucune plateforme. Certaines plateformes exposent moins d'historique pour un compte donné ; Synchronisation des statistiques indique l'horizon exact par compte.