Resumen de estadísticas

Tres endpoints responden a "cómo nos fue": uno con el total, uno con la tendencia y uno con la comparación entre plataformas. Los tres leen los mismos números. Las estadísticas cubren Facebook, Instagram, Threads, TikTok, Pinterest, Bluesky y YouTube durante los últimos 180 días. X no tiene estadísticas aquí, y las de LinkedIn están a la espera de la aprobación de LinkedIn, así que ambas no devuelven nada.

Parámetros del periodo

Parameter	Description
from	Inicio del periodo, en ISO 8601. Obligatorio
to	Fin del periodo, en ISO 8601, no anterior a `from`. Obligatorio
platforms	Restringe a estas plataformas. Repite la clave por cada valor. Omítelo para incluir todas las plataformas cubiertas

Las métricas cuentan las publicaciones publicadas dentro del periodo. Cada valor viene acompañado de la misma métrica para el periodo de igual duración inmediatamente anterior a from, así que un periodo de 30 días se compara con los 30 días anteriores.

GET /api/v1/analytics/overview

GET /api/v1/analytics/overview?from=2026-08-01&to=2026-08-31&platforms=INSTAGRAM&platforms=TIKTOK

{
  "views": { "value": 48210, "previousValue": 39100, "deltaPercent": 23.3 },
  "likes": { "value": 2210, "previousValue": 1980, "deltaPercent": 11.6 },
  "comments": { "value": 340, "previousValue": 410, "deltaPercent": -17.1 },
  "shares": { "value": 128, "previousValue": null, "deltaPercent": null },
  "followers": { "value": 12980, "previousValue": 12410, "deltaPercent": 4.6 },
  "postsCount": { "value": 42, "previousValue": 37, "deltaPercent": 13.5 },
  "avgViewsPerPost": { "value": 1147.9, "previousValue": 1056.8, "deltaPercent": 8.6 },
  "engagementRate": { "value": 5.55, "previousValue": 6.11, "deltaPercent": -9.2 },
  "partialMetrics": ["shares"],
  "lastSyncedAt": "2026-09-08T06:12:41.000Z"
}

Field	Description
value	La métrica del periodo solicitado
previousValue	La misma métrica para el periodo anterior de igual duración
deltaPercent	Cambio de `previousValue` a `value`. Es null cuando el valor anterior es 0 o se desconoce
followers	Último recuento de seguidores a fecha de `to`, comparado con el recuento al final del periodo anterior
engagementRate	Me gusta, comentarios y compartidos divididos entre las visualizaciones, como porcentaje
partialMetrics	Métricas que al menos una de las plataformas seleccionadas no puede reportar. Sus totales solo cubren las plataformas que sí pueden
lastSyncedAt	Sincronización exitosa más reciente entre las plataformas seleccionadas

Una métrica que ninguna plataforma seleccionada reporta es null. Eso significa "no medido", no cero.

GET /api/v1/analytics/timeseries

GET /api/v1/analytics/timeseries?from=2026-08-01&to=2026-08-31&granularity=WEEKLY

Añade granularity: DAILY (por defecto), WEEKLY o MONTHLY.

{
  "points": [
    {
      "date": "2026-08-03T00:00:00.000Z",
      "views": 11820,
      "likes": 590,
      "comments": 82,
      "shares": 31,
      "followers": 12520,
      "postsCount": 10,
      "engagementRate": 5.9
    }
  ]
}

date es el inicio del bucket en UTC. followers es el último recuento conocido al final del bucket. Los demás contadores suman las publicaciones publicadas dentro de él.

GET /api/v1/analytics/platform-breakdown

GET /api/v1/analytics/platform-breakdown?from=2026-08-01&to=2026-08-31

Solo acepta from y to. Devuelve { "platforms": [...] } con una fila por cada plataforma que tiene datos en el espacio de trabajo. Cada fila lleva las métricas del resumen para esa plataforma más supportedMetrics, la lista de métricas que la plataforma reporta. Compara dos plataformas solo en las métricas que ambas incluyen ahí: una fila de Pinterest con shares en null no está perdiendo frente a Instagram en compartidos, simplemente no los reporta.

Actualización de los datos

Los números se actualizan solos cada pocas horas. Si acabas de publicar y quieres los números ahora, consulta Sincronización de estadísticas.