Analytics from the CLI

A channel, live

nadia stats <channel-id>             # the last 7 days
nadia stats <channel-id> --days 30

Read live from the provider. The answer is an array of metrics, each with its daily points:

[
  {
    "label": "Followers",
    "data": [
      { "total": "1250", "date": "2026-10-01" },
      { "total": "1280", "date": "2026-10-02" }
    ],
    "percentageChange": 2.4
  }
]

A post

nadia get-post-analytics <post-id> --date 7

Same shape, for one published post. A draft or a queued post has none, and neither does a post whose releaseId is "missing", see Connecting a post.

The collected history

The numbers above are asked to the provider when you run the command. UseNadia also collects them every 30 minutes and keeps the series, which gives you what the provider no longer answers:

nadia get-account-history <channel-id> --from 2026-09-01 --to 2026-09-30
nadia list-video-performance <channel-id>      # per-video performance
nadia get-video-history <channel-id> --video-id <id>   # one video's series
nadia get-contents-performance                 # the numbers of the board's published cards

nadia <command> --help lists each one’s flags.

Scripting

# The follower trend over 30 days
nadia stats "$IG" --days 30 | jq '.[] | select(.label=="Followers")'

# The change of every metric
nadia stats "$IG" | jq '.[] | {label, percentageChange}'

# The latest total of each metric of a post
nadia get-post-analytics "$POST" --date 7 | jq '.[] | {label, latest: .data[-1].total}'