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-channelReturns the same time series sliced by channel rather than collapsed. Use it for the stacked-channel variant of the engagement chart.