Skip to content

Engagement Trends

Endpoint

GET /api/v1/analytics/engagement-trend?from=&to=&accounts=&labels=&campaign=&granularity=

Returns a time-series of aggregate engagement (likes + comments + shares + saves) across the date range, grouped by granularity (day default, optionally week or month).

What's plotted

The trend chart sums likes, comments, and shares per bucket. Each datapoint also carries:

  • impressions — sum.
  • reach — sum.
  • engagement_rate — weighted average across snapshots in the bucket.
  • posts — count of unique posts contributing to the bucket.

Filters

  • accounts — comma-separated channel IDs.
  • labels — comma-separated label IDs.
  • campaign — single campaign ID.
  • from / to — ISO-8601; default 30 days back to now.

Layer the filters to compare a single channel vs. another, or to isolate a campaign's contribution to overall engagement.

Sister endpoint

GET /api/v1/analytics/posts-by-channel

Returns the same time series sliced by channel rather than collapsed. Use it for the stacked-channel variant of the engagement chart.