API Reference
Analytics
UniPost analytics covers both per-post performance and workspace-level rollups. The goal is to let you power dashboards, reports, or agent feedback loops from one layer without stitching together platform-specific analytics APIs.
Unified metric model
UniPost normalizes platform metrics into a shared shape: impressions, reach, likes, comments, shares, saves, clicks, and video views. Metrics a platform does not expose are returned as zero.
Key endpoints
| Endpoint | Use case |
|---|---|
| /v1/analytics/summary | Totals and period-over-period overview |
| /v1/analytics/trend | Time-series trend charting |
| /v1/analytics/by-platform | Breakdown by destination network |
| /v1/social-posts/{id}/analytics | Detailed metrics for one post |
Examples
curl "https://api.unipost.dev/v1/analytics/summary?start_date=2026-04-01&end_date=2026-04-30" \
-H "Authorization: Bearer up_live_xxxx"Behavior notes
- Analytics is cached and refreshed in the background for supported platforms.
- Soft-deleted posts are excluded from rollups and analytics views.
- Archived posts still appear in analytics because archive is an organizational state, not a reporting delete.