analytics:aggregated

Get aggregated KPI metrics for an account over a date range: impressions, engagement, follower count, and publishing stats.

Usage

simplified analytics:aggregated [options]

Options

FlagShortTypeRequiredDescription
--accounts-astringAccount ID
--fromstringStart date YYYY-MM-DD
--tostringEnd date YYYY-MM-DD (must be today or earlier)

Example

simplified analytics:aggregated \
  -a ACCOUNT_ID \
  --from 2026-03-01 \
  --to 2026-03-31

Response

Returns a JSON object with aggregated metrics:

{
  "impressions": 12400,
  "engagement": 830,
  "follower_count": 5200,
  "posts_published": 14
}

Note: --to must be today or earlier — analytics only covers historical data.