Skip to content
Docs

Guide

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

Updated Oct 14, 2026

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 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

Terminal
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 resources.

Inbox analytics

GET /v1/analytics/inbox/volume, /heatmap, /source-breakdown, /response-time, /top-accounts and /conversations measure the 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.