Estadísticas por publicación
Visualizaciones, me gusta, comentarios, compartidos, guardados, alcance e interacción por publicación para cada publicación publicada en un periodo, ordenable por cualquier métrica, además de las publicaciones que AdaptlyPost encontró en tus cuentas pero no publicó.
Las estadísticas por publicación responden a "cómo le fue a esta publicación" y "qué publicaciones tuvieron mejor rendimiento". Cubren las publicaciones publicadas a través de AdaptlyPost y las publicaciones descubiertas en las cuentas conectadas, así que una publicación hecha en la app nativa también aparece con sus números.
Esto es rendimiento, no entrega. Resultados de publicación te dice si una publicación llegó a cada plataforma; este endpoint te dice qué pasó después de que llegara.
GET /api/v1/analytics/posts
GET /api/v1/analytics/posts?from=2026-08-01&to=2026-08-31&sortBy=VIEWS&page=1&limit=20
| Parameter | Description |
|---|---|
| from, to | El periodo, en ISO 8601. Las publicaciones se seleccionan por fecha de publicación. Obligatorio |
| platforms | Restringe a estas plataformas. Repite la clave por cada valor |
| sortBy | VIEWS, LIKES, COMMENTS, SHARES, SAVES, CLICKS, IMPRESSIONS, ENGAGEMENT_RATE o PUBLISHED_AT (por defecto). Descendente |
| page | Número de página, desde 1 |
| limit | Publicaciones por página, de 1 a 100, por defecto 20 |
{
"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
}| Field | Description |
|---|---|
| id | ID del registro de estadísticas. El único ID que tiene toda publicación rastreada |
| postId | El ID de publicación de AdaptlyPost, utilizable con Obtener publicación. Null para una publicación descubierta en la cuenta |
| postPlatformId | El platformId de Resultados de publicación. Null para publicaciones descubiertas |
| permalink | URL pública de la publicación en la plataforma, cuando se conoce |
| metrics | Últimos contadores capturados. Una métrica que la plataforma no reporta es 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
Las mismas filas sin paginación: las limit publicaciones principales (de 1 a 50, por defecto 10) ordenadas por sortBy (por defecto VIEWS). Devuelve { "posts": [...] }.
GET /api/v1/analytics/discovered-posts
GET /api/v1/analytics/discovered-posts?from=2026-08-01&to=2026-08-31&limit=200
Publicaciones encontradas en las cuentas conectadas que AdaptlyPost no publicó, para un calendario de solo lectura. Sus métricas están en /analytics/posts; este endpoint devuelve la publicación en sí.
{
"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 acepta de 1 a 1000 y por defecto es 200.
Hasta cuándo llega el historial
No se lista nada publicado hace más de 180 días, en ninguna plataforma. Algunas plataformas exponen menos historial para una cuenta determinada; Sincronización de estadísticas reporta el horizonte exacto por cuenta.