# Analytics

> Post metrics, account analytics, platform-native insights, best time to post and inbox analytics, normalized across networks.

Socialit stores daily snapshots of account and post metrics, so history survives even when a network only returns recent data. Everything is in the [Analytics](/docs/api-reference/analytics/) reference (MCP toolset `analytics`).

## Conventions

- `from_date` and `to_date` are UTC days (`YYYY-MM-DD`, inclusive).
- `account_id`, `profile_id` and `platform` filter every aggregate; you only see accounts you can access.
- `source=all|socialit|external` separates posts published through Socialit from posts imported from the network.
- Metrics are normalized: `impressions`, `reach`, `views`, `likes`, `comments`, `shares`, `saves`, `clicks`. A metric a network does not report is `null`, never `0`.
- `engagement_rate` is a percentage: engagements ÷ (impressions, else reach, else views) × 100.

## Post analytics

```bash
curl "https://api.socialit.com/v1/analytics?platform=instagram&from_date=2026-09-01&to_date=2026-09-30&sort=engagement_rate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

| Endpoint | Returns |
|---|---|
| `GET /v1/analytics` | Paginated post analytics with an overview |
| `GET /v1/analytics/posts/{postId}` | One post (`pst_…`, `sp_…` or a network post ID); `202` while a sync is pending |
| `GET /v1/analytics/post-timeline?post_id=…` | Daily metric history of one post |
| `GET /v1/analytics/delta?cursor=…` | Only what changed since your last cursor (sync into your warehouse) |
| `POST /v1/posts/sync-external` | Import posts published natively on the network now |

## Aggregates

`GET /v1/analytics/dashboard`, `/daily-metrics`, `/best-time`, `/content-decay` and `/posting-frequency` answer the usual questions: how are we doing, when should we post, how fast do posts fade and does posting more help. `GET /v1/accounts/follower-stats` returns follower counts and growth.

## Account and platform-native insights

- `GET /v1/analytics/accounts/{accountId}` returns stored account analytics for any network, `…/demographics` the audience, and `…/reports/{report}` runs a network report live.
- Native insights keep each network's own vocabulary: YouTube channel insights, daily views, retention and demographics; Instagram account insights, follower history and online followers; Facebook Page insights, post earnings and reactions; TikTok account insights; LinkedIn organization and personal stats; Google Business Profile performance and search keywords.
- `POST /v1/analytics/accounts/{accountId}/sync` queues a refresh; `analytics.synced` fires when a sync cycle completes.

Deeper, network-specific analytics (YouTube Analytics groups and reporting jobs, Reddit traffic, Pinterest audience insights…) are [Focus mode](/docs/focus-mode/) resources.

## Inbox analytics

`GET /v1/analytics/inbox/volume`, `/heatmap`, `/source-breakdown`, `/response-time`, `/top-accounts` and `/conversations` measure the [inbox](/docs/inbox/): message volume, busy hours, response times and per-conversation stats. They need the `inbox` feature.

## History and network rules

Your plan sets how far back you can read: 30 days on Free, 1 year on Pro, 2 years on Business, unlimited on Enterprise. An older `from_date` answers `403 analytics_history_limit`.

Some networks restrict how their numbers may be combined. YouTube figures are never merged into cross-network totals: aggregates carry `calculated: true` and a `platform_breakdown`, and YouTube engagement rate is `null`. Pinterest analytics are fetched live and never stored, so stored aggregates exclude Pinterest.

---

Source: https://socialit.com/docs/analytics/
