Guide
Analytics
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_dateandto_dateare UTC days (YYYY-MM-DD, inclusive).account_id,profile_idandplatformfilter every aggregate; you only see accounts you can access.source=all|socialit|externalseparates 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 isnull, never0. engagement_rateis a percentage: engagements ÷ (impressions, else reach, else views) × 100.
Post analytics
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,…/demographicsthe 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}/syncqueues a refresh;analytics.syncedfires 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.