Synupv1
Crear clave
v1Recursos/Posts/getObtener analíticas de publicaciones

Obtener analíticas de publicaciones

Devuelve un resumen de analíticas de interacción — totales generales, un desglose por plataforma, series de tendencia y las publicaciones destacadas — a través de las conexiones de plataforma a nivel de marca de un cliente.

get/api/v1/posts/analytics
posts:read
Parámetros de consulta
clientIdstringobligatorio
El cliente a resumir. Obligatorio.
fromstringopcional
Inicio del período del informe. El valor predeterminado es hace 30 días.
tostringopcional
Fin del período del informe. El valor predeterminado es ahora.
Respuesta
dataobjectopcional
summaryobjectopcional
Totales de interacción del período actual.
totalPostsnumberopcional
Número de publicaciones en este período.
totalViewsnumberopcional
Total de vistas en este período.
totalReactionsnumberopcional
Total de reacciones en este período.
totalSharesnumberopcional
Total de veces compartido en este período.
totalCommentsnumberopcional
Total de comentarios en este período.
periodDaysnumberopcional
Duración del período del informe, en días.
prevSummaryobjectopcional
Totales de interacción del período anterior inmediato, de igual duración, para la comparación de variación.
totalPostsnumberopcional
Número de publicaciones en este período.
totalViewsnumberopcional
Total de vistas en este período.
totalReactionsnumberopcional
Total de reacciones en este período.
totalSharesnumberopcional
Total de veces compartido en este período.
totalCommentsnumberopcional
Total de comentarios en este período.
byPlatformarray of objectopcional
Totales de interacción desglosados por plataforma para este período.
platformstringopcional
La plataforma a la que corresponde esta fila.
labelstringopcional
Nombre visible de la plataforma.
totalPostsnumberopcional
Número de publicaciones en este período.
totalViewsnumberopcional
Total de vistas en este período.
totalReactionsnumberopcional
Total de reacciones en este período.
totalSharesnumberopcional
Total de veces compartido en este período.
totalCommentsnumberopcional
Total de comentarios en este período.
prevByPlatformarray of objectopcional
Totales de interacción desglosados por plataforma para el período anterior.
platformstringopcional
La plataforma a la que corresponde esta fila.
labelstringopcional
Nombre visible de la plataforma.
totalPostsnumberopcional
Número de publicaciones en este período.
totalViewsnumberopcional
Total de vistas en este período.
totalReactionsnumberopcional
Total de reacciones en este período.
totalSharesnumberopcional
Total de veces compartido en este período.
totalCommentsnumberopcional
Total de comentarios en este período.
trendobjectopcional
Recuentos diarios de vistas por plataforma a lo largo del período.
datesarray of stringopcional
Las fechas cubiertas por esta tendencia, como cadenas YYYY-MM-DD.
seriesarray of objectopcional
Una entrada por plataforma.
platformstringopcional
La plataforma a la que corresponde esta fila.
labelstringopcional
Nombre visible de la plataforma.
valuesarray of numberopcional
Un valor por fecha en dates, en el mismo orden.
engagementTrendobjectopcional
Vistas, reacciones, veces compartido, comentarios y alcance diarios por plataforma a lo largo del período.
datesarray of stringopcional
Las fechas cubiertas por esta tendencia, como cadenas YYYY-MM-DD.
seriesarray of objectopcional
Una entrada por plataforma.
platformstringopcional
La plataforma a la que corresponde esta fila.
labelstringopcional
Nombre visible de la plataforma.
viewsarray of numberopcional
reactionsarray of numberopcional
sharesarray of numberopcional
commentsarray of numberopcional
reacharray of numberopcional
Valores de alcance diarios, en el mismo orden que dates.
postsTrendobjectopcional
Recuentos diarios de publicaciones enviadas por plataforma a lo largo del período.
datesarray of stringopcional
Las fechas cubiertas por esta tendencia, como cadenas YYYY-MM-DD.
seriesarray of objectopcional
Una entrada por plataforma.
platformstringopcional
La plataforma a la que corresponde esta fila.
labelstringopcional
Nombre visible de la plataforma.
valuesarray of numberopcional
Un valor por fecha en dates, en el mismo orden.
allPostsarray of objectopcional
Los envíos individuales con los que se construye este resumen, ordenados por vistas.
submissionIdstringopcional
Identificador único del envío a la plataforma.
platformstringopcional
La plataforma a la que corresponde esta fila.
platformPostIdstringopcional
El id propio de la plataforma para la publicación publicada, o null.
postLinkstringopcional
URL pública de la publicación publicada en esta plataforma, o null.
publishedAtstringopcional
Cuándo se publicó este envío, como marca de tiempo ISO 8601, o null.
contentPreviewstringopcional
El nombre de la publicación, para mostrar.
totalViewsnumberopcional
Total de vistas en este período.
totalReactionsnumberopcional
Total de reacciones en este período.
totalSharesnumberopcional
Total de veces compartido en este período.
totalCommentsnumberopcional
Total de comentarios en este período.
totalReachnumberopcional
Alcance total de este envío.
engRatenumberopcional
Tasa de interacción — reacciones más veces compartido más comentarios, como porcentaje de las vistas — o null si aún no hay vistas.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/posts/analytics
Su clave de API
clientId *
from
to
{
  "data": {
    "summary": {
      "totalPosts": 18,
      "totalViews": 5400,
      "totalReactions": 320,
      "totalShares": 44,
      "totalComments": 61,
      "periodDays": 30
    },
    "prevSummary": {
      "totalPosts": 14,
      "totalViews": 4100,
      "totalReactions": 260,
      "totalShares": 30,
      "totalComments": 48
    },
    "byPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 10,
        "totalViews": 3200,
        "totalReactions": 210,
        "totalShares": 30,
        "totalComments": 40
      },
      {
        "platform": "instagram",
        "label": "Instagram",
        "totalPosts": 8,
        "totalViews": 2200,
        "totalReactions": 110,
        "totalShares": 14,
        "totalComments": 21
      }
    ],
    "prevByPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 8,
        "totalViews": 2500,
        "totalReactions": 170,
        "totalShares": 20,
        "totalComments": 32
      }
    ],
    "trend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            4,
            6
          ]
        }
      ]
    },
    "engagementTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "views": [
            180,
            210
          ],
          "reactions": [
            12,
            15
          ],
          "shares": [
            2,
            3
          ],
          "comments": [
            4,
            5
          ],
          "reach": [
            900,
            1100
          ]
        }
      ]
    },
    "postsTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            1,
            2
          ]
        }
      ]
    },
    "allPosts": [
      {
        "submissionId": "cm_sub_xyz789",
        "platform": "facebook",
        "platformPostId": "1234567890",
        "postLink": "https://www.facebook.com/1234567890",
        "publishedAt": "2026-01-16T14:00:00.000Z",
        "contentPreview": "Join us this weekend for our fall special — 20% off all services!",
        "totalViews": 890,
        "totalReactions": 42,
        "totalShares": 6,
        "totalComments": 9,
        "totalReach": 1450,
        "engRate": 0.064
      }
    ]
  }
}