Analytics

The analytics endpoints expose the same numbers that back the dashboard analytics screen. Metrics are refreshed by a background job every 30 minutes.

Per-content metrics

GET /api/v1/content/{id}/analytics

{
  "object": "content_analytics",
  "content_id": "cnt_9f2c8e7b1a3d4f60",
  "as_of": "2026-07-19T12:00:00Z",
  "platforms": [
    {
      "platform": "instagram",
      "platform_post_id": "17987654321012345",
      "impressions": 12800,
      "reach": 9400,
      "likes": 412,
      "comments": 27,
      "shares": 58,
      "saves": 34,
      "video_views": null
    },
    {
      "platform": "tiktok",
      "platform_post_id": "7391812390000000000",
      "impressions": null,
      "reach": null,
      "likes": 1180,
      "comments": 63,
      "shares": 210,
      "saves": null,
      "video_views": 22400
    }
  ]
}

Metrics that a platform does not expose are null, not zero.

Workspace summary

GET /api/v1/analytics/summary?window=7d

Query parameters:

Name	Notes
window	1d, 7d (default), 30d, 90d.
platform	Optional filter.

{
  "object": "analytics_summary",
  "window": "7d",
  "totals": {
    "posts_published": 24,
    "impressions": 483200,
    "engagement": 15840
  },
  "by_platform": [
    { "platform": "instagram", "posts": 12, "impressions": 210000, "engagement": 7900 },
    { "platform": "tiktok",    "posts": 8,  "impressions": 260000, "engagement": 6900 },
    { "platform": "x",         "posts": 4,  "impressions": 13200,  "engagement": 1040 }
  ]
}

Availability

Analytics require the workspace to have connected a platform with an official analytics API (Instagram Business, TikTok, YouTube, Facebook, LinkedIn). Posts to X return only public counts. WhatsApp does not expose per-message analytics.

Latency

Because metrics refresh every 30 minutes, a post that published five minutes ago will return null metrics until the next refresh. Poll on a 30 to 60 minute cadence, not more.