antworkDOCS

Interacción por día

La interacción conseguida por día y por plataforma, y los seguidores por cuenta: una tabla para graficar.

GEThttps://antwork.io/api/v1/analytics/dailyPermisoread

Petición

curl "https://antwork.io/api/v1/analytics/daily?days=7" \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

Las mismas tablas que la herramienta MCP get_engagement_history, de la misma función. days es la ventana hacia atrás, hoy incluido, de 1 a 365 (30 por defecto). Necesita el permiso read.

Respuesta

200 OK
{
  "object": "engagement_history",
  "schema": { "fields": [
    { "name": "date", "type": "DATE", "mode": "NULLABLE" },
    { "name": "platform", "type": "STRING", "mode": "NULLABLE" },
    { "name": "likes", "type": "INTEGER", "mode": "NULLABLE" },
    ...
  ] },
  "rows": [
    { "date": "2026-10-21", "platform": "linkedin", "likes": 7, "comments": 3, "shares": 1,
      "impressions": 210, "reachBasis": "impressions", "reach": null, "profileVisits": 4,
      "degraded": null, "awaitingPermission": null, ... },
    { "date": "2026-10-21", "platform": "all", "likes": 7, "comments": 3, "shares": 1,
      "impressions": 210, "reachBasis": "impressions", "reach": null, ... }
  ],
  "rowCount": 14,
  "workspaceId": "ws_...",
  "days": 7,
  "startDate": "2026-10-16",
  "endDate": "2026-10-22",
  "platforms": ["linkedin"],
  "platformTotals": { "linkedin": { "likes": 31, "comments": 9, "shares": 4, "impressions": 1480 } },
  "rangeTotals": { "likes": 31, "comments": 9, "shares": 4, "impressions": 1480 },
  "followers": {
    "schema": { "fields": [ ... ] },
    "rows": [
      { "date": "2026-10-21", "accountId": "acc_...", "accountName": "Antwork", "platform": "linkedin",
        "followers": 415, "dailyChange": 5, "approximate": null, "unavailableReason": null }
    ],
    "rowCount": 7
  }
}

schema da el nombre y el tipo de cada columna; rows tiene una fila por fecha y plataforma, más una fila all por fecha. Una celda null es un día sin medición o un campo que la plataforma no ofrece: dibuja un hueco. Un 0 es un cero medido. reachBasis dice qué cuenta impressions (impresiones, visualizaciones o alcance); bases distintas no se suman, así que las impresiones de la fila all son null en un día que las mezcla, y su alcance siempre es null. degraded señala ceros que son artefactos, y awaitingPermission los campos que la plataforma aún no ha liberado.

followers es una segunda tabla, una fila por fecha y cuenta: el número (null, nunca 0, cuando no se pudo leer, con unavailableReason), dailyChange frente al día contado anterior de la cuenta, y approximate donde la plataforma redondea (YouTube).

postId

curl "https://antwork.io/api/v1/analytics/daily?postId=pQ7x..." \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

Con postId, una sola publicación: columnas cumulative* y daily* para cada contador, por plataforma. Sin days, todo su historial. Un spanDays mayor que 1 significa que el valor diario cubre varios días desde la lectura anterior; unreadableFields se arrastraron de una lectura anterior.

Las métricas se actualizan cada seis horas y el resumen diario se calcula una vez al día, así que la última fila suele ser la de ayer. Un message que dice que aún no hay datos diarios es la respuesta para cualquier days.