Analítica
Cómo les fue a las publicaciones de un espacio de trabajo en las plataformas, tal como lo informan las plataformas: visualizaciones, impresiones, alcance, me gusta, comentarios, veces compartida y guardada, clics en enlaces y seguidores. Las cifras se leen de las cuentas en las que los canales del espacio de trabajo publican a través del conector de plataforma de Reelwire, en Facebook, Instagram, LinkedIn, Pinterest, Threads, TikTok, X y YouTube, así que una publicación entregada por correo electrónico o por webhook no tiene ninguna, ni tampoco Discord, Telegram y Slack. La pantalla Analítica muestra lo mismo.
La analítica viene con los planes que incluyen el servicio de publicación del conector de plataforma, Individual y Business; en Free cada ruta responde un 403 con una frase que lo dice.
| Método | Ruta | Permiso |
|---|---|---|
GET | /v1/analytics | posts:read |
GET | /v1/analytics/posts | posts:read |
GET | /v1/analytics/posts/{id} | posts:read |
Leído en vivo. No se guarda nada: las plataformas informan cifras nuevas cada pocas horas, y Reelwire conserva cada respuesta diez minutos, así que preguntar antes da la misma respuesta. readAt dice cuándo se leyeron las cifras.
Elegir el periodo
Las tres aceptan los mismos parámetros:
| Parámetro | Qué hace |
|---|---|
from, to | El periodo, días completos escritos YYYY-MM-DD, ambos incluidos. Los últimos 30 días si no se indica ninguno, como máximo un año, nunca más allá de hoy. |
platform | Una plataforma, por el id con que la nombra GET /v1/channels/surfaces: instagram, youtube, x... |
channelId | Un canal: las cifras de la cuenta en la que publica su conector de plataforma. Un 404 si no publica en ninguna. |
source | reelwire, el valor predeterminado, las publicaciones que hizo el conector de plataforma de Reelwire; all, todas las publicaciones de las cuentas conectadas, también las publicadas de otra manera. |
Las cifras del periodo
curl "http://localhost:4000/v1/analytics?from=2026-10-19&to=2026-11-17" \
-H "Authorization: Bearer rw_your_key_here"
{
"available": true,
"period": { "from": "2026-10-19", "to": "2026-11-17", "days": 30 },
"previousPeriod": { "from": "2026-09-19", "to": "2026-10-18" },
"source": "reelwire",
"totals": { "posts": 23, "views": 18420, "impressions": 26110, "reach": 9870, "likes": 812, "comments": 64, "shares": 51, "saves": 37, "clicks": 12, "engagement": 964, "engagementRate": 3.69 },
"previous": { "posts": 17, "views": 12100, "...": "the same numbers" },
"daily": [{ "date": "2026-10-19", "posts": 1, "views": 640, "...": "the same numbers" }],
"platforms": [{ "platform": "instagram", "label": "Instagram", "posts": 6, "views": 7300, "...": "the same numbers" }],
"accounts": [
{
"accountId": "acc_...",
"platform": "instagram",
"label": "Instagram",
"name": "@yourbusiness",
"channels": [{ "id": "ch_...", "name": "Instagram EN" }],
"followers": 1200,
"growth": 40,
"growthPercent": 3.4,
"updatedAt": "2026-11-17T04:00:00.000Z",
"history": [{ "date": "2026-10-19", "followers": 1160 }]
}
],
"bestTimes": [{ "day": 0, "hour": 9, "engagement": 12.35, "posts": 3 }],
"readAt": "2026-11-17T12:00:00.000Z"
}
engagementson los me gusta, comentarios, veces compartida y guardada en total;engagementRatees la interacción frente a las impresiones, si no el alcance, si no las visualizaciones, en porcentaje,nulldonde no se vio nada. Donde se suman plataformas (totals,previous,daily), las interacciones de cada plataforma cuentan frente a su propia cifra y se dividen las sumas, así que los me gusta de una plataforma nunca se miden frente a las impresiones de otra. Las demás cifras son sumas simples de lo que cada plataforma informa con ese nombre: una visualización, una impresión y el alcance no significan lo mismo en todas las plataformas.previouses el periodo de la misma duración justo anterior, para el cambio.dailycontiene cada día del periodo,0donde no pasó nada. La interacción cuenta el día en que llegó.platformssolo lista las plataformas con publicaciones en el periodo. Las plataformas cuentan de forma distinta: LinkedIn informa impresiones en lugar de visualizaciones, por ejemplo.accountses cada cuenta conectada a través del servicio de publicación, con los canales que publican en ella. Las plataformas cuentan los seguidores una vez al día.bestTimeses la interacción media de las publicaciones que salieron en cada hora de la semana:day0 es el lunes yhourestá en UTC.
Si el espacio de trabajo no tiene ninguna cuenta conectada a través del servicio de publicación, la respuesta es { "available": false, "reason": "no-accounts" }.
Las publicaciones
curl "http://localhost:4000/v1/analytics/posts?sort=views&perPage=10" \
-H "Authorization: Bearer rw_your_key_here"
Una fila por publicación y plataforma, las más recientes primero salvo que sort nombre uno de publishedAt, views, impressions, reach, engagement, engagementRate, likes, comments, shares, saves o clicks (los más altos primero, ascending=true al revés). q busca en el texto de la publicación, la plataforma, y el canal, la marca y el título de una publicación hecha por Reelwire; page y perPage (de 5 a 100, 25 por defecto) la paginan, como en toda lista (Paginación).
{
"available": true,
"period": { "from": "2026-10-19", "to": "2026-11-17" },
"total": 23,
"all": 23,
"page": 1,
"perPage": 10,
"posts": [
{
"id": "6a1f...",
"platform": "instagram",
"label": "Instagram",
"accountId": "acc_...",
"publishedAt": "2026-11-16T09:00:00.000Z",
"url": "https://www.instagram.com/reel/...",
"text": "Spring opening on Monday...",
"ours": { "postId": "post_...", "postGroupId": "grp_...", "title": "Spring opening", "channelId": "ch_...", "channelName": "Instagram EN", "brandName": "Acme" },
"numbers": { "views": 2100, "impressions": 3400, "reach": 1800, "likes": 120, "comments": 9, "shares": 4, "saves": 6, "clicks": 0, "engagement": 139, "engagementRate": 4.09 }
}
],
"readAt": "2026-11-17T12:00:00.000Z"
}
ours nombra la publicación que hizo Reelwire, null para una publicada en la cuenta de otra manera. Para un periodo se leen como máximo mil publicaciones.
Una publicación
GET /v1/analytics/posts/{id} acepta el id que da una fila, o el id de publicación propio de Reelwire, y responde con la publicación en cada plataforma donde salió, con lo que añaden algunas plataformas, y sus cifras día a día desde que salió:
{
"id": "6a1f...",
"publishedAt": "2026-11-16T09:00:00.000Z",
"text": "Spring opening on Monday...",
"ours": { "postId": "post_...", "title": "Spring opening", "channelName": "Instagram EN", "brandName": "Acme", "...": "as above" },
"platforms": [
{
"platform": "instagram",
"label": "Instagram",
"url": "https://www.instagram.com/reel/...",
"numbers": { "views": 2100, "...": "as above" },
"extra": { "follows": 3, "averageWatchSeconds": 4.3, "completionRate": 42, "skipRate": null }
}
],
"timeline": [{ "date": "2026-11-16", "platform": "instagram", "views": 1500, "...": "the same numbers" }]
}
extra es null donde la plataforma no dice nada: averageWatchSeconds en segundos, completionRate y skipRate en porcentaje. Una publicación de otro espacio de trabajo, o una de la que las plataformas aún no tienen cifras, es un 404; las primeras cifras de una publicación llegan pocas horas después de que sale.