📊 Analytics Dashboard
The Analytics Dashboard is your command center for social media performance. It aggregates real-time data from every connected platform into a unified view, giving you instant clarity on what's working and where to focus next.
Key Metrics at a Glance​
The top section of the dashboard displays your most critical KPIs for the selected time range:
| Metric | Description | Source |
|---|---|---|
| Total Reach | Unique users who saw your content | Platform APIs |
| Total Impressions | Total number of times content was displayed | Platform APIs |
| Engagement Rate | (Likes + Comments + Shares) / Reach | Calculated |
| Saves & Downloads | Content bookmarked or downloaded by users | Platform APIs |
| Revenue Attributed | Sales tracked back to social posts via UTM | E-commerce integration |
| Follower Growth | Net new followers across all platforms | Platform APIs |
The dashboard calls GET /analytics/dashboard with your selected filters. Internally, the getDashboardAnalytics(workspaceId, userId, params) method aggregates data from the PostMetric model, which stores per-post snapshots including likes, comments, shares, impressions, reach, saves, downloads, engagementRate, and raw platform data as JSON.
Filtering & Time Ranges​
Use the filter bar to narrow down your dashboard view:
| Parameter | Options |
|---|---|
| Date Range | Last 7 days, 30 days, 90 days, or custom startDate / endDate |
| Platform | All, Facebook, Instagram, TikTok (or any connected account) |
| Account | Filter by specific social account via accountId |
| Sort | Sort by any metric — sortBy and sortOrder (asc/desc) |
| Pagination | Control results with page and limit for post lists |
Use the custom date range to align dashboards with your campaign windows or reporting cycles. The API accepts ISO 8601 date strings for startDate and endDate.
Time-Series Charts​
Visualize how your metrics trend over time with interactive line and area charts. The dashboard supports two views:
- Aggregated time series — All platforms combined on a single chart (
GET /analytics/timeseries) - Platform breakdown — Separate trend lines per platform (
GET /analytics/timeseries/by-platform)
This is powered by the getTimeSeriesMetrics and getTimeSeriesMetricsByPlatform service methods, which return bucketed metric data over your selected date range.
Platform Breakdown​
A side-by-side comparison table shows how each connected platform is performing:
| Platform | Reach | Impressions | Engagement Rate | Revenue |
|---|---|---|---|---|
| — | — | — | — | |
| — | — | — | — | |
| TikTok | — | — | — | — |
This helps you identify where your audience is most active and which platform delivers the best ROI.
Top Performing Content​
A ranked list of your best posts for the selected period, sortable by:
- Engagement rate
- Total reach
- Revenue attributed
- Virality (shares / impressions)
Click any post to drill into its detailed analytics.
AI Insights​
The dashboard surfaces AI-generated insights based on your data patterns:
- "Your Reels are getting 3x more engagement than static posts"
- "Posting between 6–8 PM drives 40% more reach"
- "Your audience engagement is trending up 15% week-over-week"
For deeper, actionable recommendations, visit the AI Advisor.
Syncing Fresh Data​
Metrics are updated automatically on a schedule. If you need the latest numbers immediately, you can trigger a manual sync:
POST /analytics/sync/:publicationId
This calls triggerMetricsSync to pull the freshest data from platform APIs and update all PostMetric snapshots (recorded via the snapshotAt timestamp).
Manual syncs are rate-limited to avoid hitting platform API quotas. Use sparingly — the automatic sync schedule covers most use cases.
Related Pages​
- Post Analytics — Deep-dive into individual post performance
- A/B Testing — Run experiments to optimize content
- Predictions — AI-powered engagement and revenue forecasting
- Revenue Attribution — Track social-to-sales conversions