Estadísticas por publicación

Permiso: analytics.read. Consulta Roles y permisos.

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
connectionIds	Restringe a estas cuentas, por su `id` de Cuentas de redes sociales. 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",
      "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
}

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
connectionId	La cuenta a la que pertenece la publicación: su `id` de Cuentas de redes sociales
accountName	Nombre visible de esa cuenta, en todas las plataformas
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

Las publicaciones del Perfil de Empresa de Google aparecen con métricas null: el Perfil de Empresa de Google solo informa impresiones de la ubicación, no por publicación.

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": [...] }. Acepta los mismos filtros platforms y connectionIds.

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",
      "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 acepta de 1 a 1000 y por defecto es 200. Se filtra con platforms y connectionIds de la misma forma.

Hasta cuándo llega el historial

Al conectar una cuenta se importan sus publicaciones de los últimos 180 días, y las estadísticas se conservan desde entonces mientras la cuenta siga conectada. Una publicación se sigue actualizando durante 180 días después de publicarse y luego conserva sus últimas cifras. Algunas plataformas exponen menos historial para una cuenta determinada; Sincronización de estadísticas reporta el horizonte exacto por cuenta.