Analytics

Read cross-account performance numbers without leaving the terminal.

Three read-only commands under fopost analytics, each taking the same window flags: --days for a rolling window, or --from/--to (YYYY-MM-DD) for an explicit one, plus --account to narrow to one account. The workspace comes from --workspace or your saved default.

Overview

fopost analytics overview --days 30

Headline totals (accounts, followers, posts, engagement, impressions, reach, likes, comments, shares, engagement rate), plus a per-platform breakdown.

Top posts

fopost analytics top-posts --days 7 --limit 10
fopost analytics top-posts --label lbl_launch        # one campaign, rolled up
fopost analytics top-posts --sort recent             # by date instead of performance

Ranked by performance unless --sort recent. --label narrows to the posts carrying one label, which is how a campaign gets its own leaderboard.

Time series

fopost analytics time-series --from 2026-08-01 --to 2026-08-31

One row per day: posts, engagements, impressions, followers. With --json it graphs from a script:

fopost analytics time-series --days 14 --json | jq -r '.[] | [.date, .engagements] | @tsv'

What each network actually reports varies. See Analytics for what the numbers mean, and the Analytics API for the shapes behind these commands.

Next

Related documentation
  • CLI

    Schedule, publish, and inspect FoPost content from your terminal, as a single static binary.

  • Posts

    Create, schedule, publish, and inspect posts from the terminal.

  • Accounts and Workspaces

    Inspect connected accounts, their health, and your workspaces.

  • Media and Labels

    Manage library assets and campaign labels from the terminal.

  • Automations and Webhooks

    Trigger automations and manage webhook subscriptions from the terminal.

  • Scripting

    JSON output, exit codes, and shell completion for automation.

  • Analytics

    Engagement, followers, top posts, best times, and audience.

  • Analytics

    Overview totals, time series, top posts, demographics, and label roll-ups.

Was this helpful?

On this page