# OmniSocials Analytics

> Followers, impressions, engagement, and per-post results for every connected channel in one dashboard. An AI assistant reads the same numbers through MCP, the API, or the CLI.

This is the machine-readable version of [omnisocials.com/analytics](https://omnisocials.com/analytics), maintained for AI agents. Start a 14-day free trial at [app.omnisocials.com/signup](https://app.omnisocials.com/signup).

## What it does

- **Overview dashboard**: total posts, impressions, engagement, average engagement rate, and the top platform, with a comparison against the previous period. The overview cards can be customized.
- **Account and follower analytics**: daily snapshots of followers, profile views, and other account metrics per connected account.
- **Post performance**: per-post metrics on every platform the post went to, including reach, clicks, and video views where the platform reports them.
- **Per-platform breakdown**: the same numbers split by platform.
- **Engagement trends**: engagement over time.
- **Story stats**: results per Story slide.
- **Best time to post**: recommended day and hour slots per platform, computed from the workspace's own posting history.
- **Reports**: printable and downloadable.
- **Date ranges**: last 7, 30, or 90 days, or a custom range.

## How metrics are collected

OmniSocials stores metric snapshots on a schedule, starting right after a post publishes.

| Post age | Refresh interval |
| --- | --- |
| 0 to 7 days | Every 2 hours |
| 8 to 30 days | Every 24 hours |
| 31 to 365 days | Every 7 days |
| Stories | Every hour during the Story's 24-hour lifetime |

Account-level snapshots are collected once per day. X is the exception for posts: X charges for every read, so an X post is read on its first refresh and then after day 1, 3, 7, and 30.

## How the numbers are defined

The dashboard, API, CLI, and MCP server all use the same definitions.

- **Engagement**: the sum of the platform's real interactions (likes, comments, shares, reposts, quotes, and similar). Where a platform gives a precomputed total, that total is used.
- **Impressions**: the best available "times seen" number. Total views first, then impressions, then reach.
- **Engagement rate**: engagement divided by impressions, as a percentage capped at 100. Below 10 impressions the rate is reported as 0.

## Best time to post

Recommendations come from the workspace's own data: publish time crossed with engagement, weighted toward recent posts. On Instagram and TikTok Business accounts, the hours when followers are online are blended in. With fewer than 15 analyzed posts on a platform, the result falls back to audience data or to an industry-average table, and the response says which basis was used.

## Limits to know

- **Platform gaps**: Bluesky and Mastodon expose no view counts. Google Business has no per-post metrics (Google discontinued them), but account-level metrics still work.
- **Extra authorization**: the deeper YouTube and TikTok metrics (watch time, completion rate, audience data) need the YouTube Analytics scope or the TikTok Business authorization.
- **Demographics**: audience demographics on Instagram, Threads, and TikTok need 100 or more followers.
- **Fresh posts**: a post published minutes ago can report zeros until the first refresh.
- **Posts made outside OmniSocials**: post-level analytics cover posts published through OmniSocials. Analytics for posts made outside OmniSocials is on the roadmap.

## Use it from an AI assistant or code

Ask an assistant "how did last week perform?" and it reads the stored snapshots. No call goes to the social platforms live, so answers are fast and do not use platform rate limits.

- **MCP tools**: `get_analytics_overview`, `get_post_analytics`, `get_posts_analytics` (up to 100 posts per call), `get_account_analytics`, `get_best_times`. Setup: [omnisocials.com/mcp.md](https://omnisocials.com/mcp.md).
- **CLI**: `analytics:overview`, `analytics:post`, `analytics:posts`, `analytics:accounts`, `analytics:best-times`. Setup: [omnisocials.com/cli.md](https://omnisocials.com/cli.md).
- **REST API and SDKs**: API keys need the `analytics:read` scope. Guide with the metric keys per platform: [docs.omnisocials.com/analytics](https://docs.omnisocials.com/analytics).

## Pricing

Analytics and reports are included in every plan. OmniSocials is $10 per workspace per month billed annually ($12 billed monthly), every feature included, with a 14-day free trial. Details: [omnisocials.com/pricing.md](https://omnisocials.com/pricing.md)

## More machine-readable pages

- [llms.txt](https://omnisocials.com/llms.txt)
- [Content scheduler](https://omnisocials.com/calendar.md)
- [Social inbox](https://omnisocials.com/inbox.md)
- [Collaboration and approvals](https://omnisocials.com/collaboration.md)
- [Workflows (automatic reposting)](https://omnisocials.com/workflows.md)
- [AI info](https://omnisocials.com/ai-info.md)