# Analytics commands

Read post metrics, daily trends, recommended posting times, and inbox volume with the right date flags and account filters.

Use `analytics:` for post performance and `inboxanalytics:` for messaging activity. These are read operations. [Authenticate](/cli/authentication) before requesting metrics.

## First command

Read one page of Instagram post analytics:

```bash
zernio analytics:posts --platform instagram --page 1 --limit 5 --pretty
```

The list response contains posts, overview metrics, and pagination. Check the selected platform, returned date range, and metric freshness before reporting totals.

## Commands

Set `ACCOUNT_ID` from `accounts:list`; set `POST_ID` from `posts:list` or a creation response.

| Task | Command | Inputs and result |
|---|---|---|
| Read post metrics | `zernio analytics:posts --accountId "$ACCOUNT_ID" --limit 10` | Account filter; page of metrics |
| Inspect one post | `zernio analytics:posts --postId "$POST_ID"` | Post ID; one post's analytics |
| Read a daily trend | `zernio analytics:daily --accountId "$ACCOUNT_ID" --from 2026-10-01 --to 2026-10-31` | Account and date range; daily metrics |
| Find posting times | `zernio analytics:best-time --accountId "$ACCOUNT_ID"` | Account filter; recommended times |
| Measure inbox volume | `zernio inboxanalytics:get-inbox-volume --fromDate 2026-10-01 --toDate 2026-10-31` | Required start date; messaging volume |

Run `zernio --help` for other inbox metrics, platform insights, and the `logs:` activity-log group. Inspect each command's `--help` for supported filters.

## Date and scope filters

| Command | Date flags | Scope flags |
|---|---|---|
| `analytics:posts` | `--from`, `--to` | `--accountId`, `--profileId`, `--platform`, `--postId`, `--source` |
| `analytics:daily` | `--from`, `--to` | `--accountId`, `--profileId`, `--platform`, `--source` |
| `analytics:best-time` | None | `--accountId`, `--profileId`, `--platform`, `--source` |
| `inboxanalytics:get-inbox-volume` | `--fromDate` required; `--toDate` optional | `--accountId`, `--profileId`, `--platform`, `--source` |

The hand-written analytics commands translate `--from` and `--to` into API date fields. Do not reuse those shortened flags on generated inbox-analytics commands.

## How it behaves

- `analytics:posts` uses page-number pagination, starting at page 1 with a default limit of 50. Request subsequent pages before aggregating totals yourself.
- Without `--postId`, the endpoint returns a list. A single-post lookup can report pending synchronization; inspect its returned state before treating metrics as complete.
- Read-only analytics requests can be repeated to check synchronization. Do not retry unrelated writes as part of a report.
- API permissions, plan access, platform support, and synchronization freshness determine which metrics are available. See the reference instead of assuming missing metrics mean zero.

## Related

- [Get analytics](/analytics/get-analytics)
- [Inbox volume](/inbox-analytics/get-inbox-volume)
- [Social webhooks](/webhooks/social)
- [Options and output](/cli/options)