analytics:range

Get daily time-series metrics for an account over a date range. Useful for charting trends.

Usage

simplified analytics:range [options]

Options

Flag	Short	Type	Required	Description
`--accounts`	`-a`	string	✅	Account ID
`--from`		string	✅	Start date `YYYY-MM-DD`
`--to`		string	✅	End date `YYYY-MM-DD` (must be today or earlier)
`--metrics`		string		Comma-separated metrics to return

Available Metrics

views · reach · follower_count · impressions · engagement · likes · comments · shares

Example

simplified analytics:range \
  -a ACCOUNT_ID \
  --metrics "views,reach,follower_count" \
  --from 2026-03-01 \
  --to 2026-03-31

Response

Returns a JSON array of daily data points:

[
  { "date": "2026-03-01", "views": 420, "reach": 310, "follower_count": 5180 },
  { "date": "2026-03-02", "views": 390, "reach": 280, "follower_count": 5195 }
]