Resumen de estadísticas

Permiso: analytics.read. Consulta Roles y permisos.

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, LinkedIn, YouTube, X y el Perfil de Empresa de Google. El Perfil de Empresa de Google solo informa impresiones de la ubicación, sin cifras por publicación. Mastodon, Telegram y Tumblr no tienen estadísticas. 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, así que puedes consultar cualquier rango de fechas de ese historial.

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
connectionIds	Restringe a estas cuentas, por su `id` de Cuentas de redes sociales. Repite la clave por cada valor. Omítelo para incluir todas las cuentas

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

Acepta from, to y connectionIds, pero no platforms. 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.