antworkDOCS

Rendimiento

Cómo les fue a tus publicaciones: métricas acumuladas por publicación y totales por plataforma.

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

Petición

curl "https://antwork.io/api/v1/analytics/performance?days=30&platform=linkedin" \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

Las mismas cifras que la página de analítica de Antwork y la herramienta MCP get_performance. Elige el periodo con days (de 1 a 730, 30 por defecto) o con from y to en formato YYYY-MM-DD. Acota con platform o accountId; compare=true añade previous, los totales del periodo anterior. Como mucho 500 filas, según limit. Requiere el permiso read.

Respuesta

200 OK
{
  "object": "performance",
  "workspaceId": "ws_...",
  "window": { "from": "2026-09-23T00:00:00.000Z", "to": "2026-10-22T12:00:00.000Z" },
  "platforms": [
    {
      "platform": "linkedin",
      "postCount": 12,
      "totals": { "likes": 340, "comments": 41, "shares": 9, "impressions": 18200 },
      "engagement": 390,
      "rate": 0.0214,
      "skipped": 0,
      "syncedAt": "2026-10-22T06:00:00.000Z",
      "oldestAsOf": "2026-10-22T06:00:00.000Z"
    }
  ],
  "rows": [
    {
      "postId": "pQ7x...",
      "platform": "linkedin",
      "text": "Shipped the API today.",
      "publishedAt": "2026-10-01T09:00:04.000Z",
      "metrics": {
        "likes": { "value": 52, "state": "measured", "asOf": "2026-10-22T06:00:00.000Z" },
        "impressions": { "value": 2400, "state": "measured", "basis": "impressions" }
      },
      "engagement": 61,
      "rate": 0.0254,
      "degraded": []
    }
  ],
  "rowCount": 12,
  "degradedRows": 0
}

Cada métrica es una celda, no un número suelto. state: "measured" lleva un value. unsupported significa que la plataforma no puede dar ese contador (Pinterest no tiene me gusta). unreadable es un valor arrastrado de una lectura anterior, con asOf indicando su antigüedad. Un dato desconocido nunca se da como 0.

Las métricas se actualizan cada seis horas. syncedAt en una plataforma indica cuándo se leyeron sus cifras por última vez.