GET /v1/analytics for unified post analytics across supported social
posting platforms.
Modes
Single-post mode fetches live metrics for supported platforms, writes an analytics snapshot, and returns per-target sync status.postId may be either a Kavenio post ID or a platform post ID already attached
to a Kavenio-created post target. Posts imported only into social_posts are
not part of Phase 1 analytics until external-post sync creates unified post
targets.
List mode reads the latest stored analytics snapshot per target. It does not
fan out to provider APIs.
Metrics
The normalized metric object includeslikes, comments, reposts, quotes,
shares, saves, impressions, reach, clicks, views,
engagementRate, and lastUpdated. Unsupported provider metrics are returned
as null and listed in unsupportedMetrics.
Live fetch support includes Bluesky, Mastodon, X, Reddit, Instagram, Facebook,
Threads, LinkedIn, TikTok, YouTube, and Pinterest. Other post targets return
syncStatus: "unavailable" until their provider fetcher is implemented.
Single-post responses that contain pending targets return HTTP 202.
LinkedIn analytics use member post statistics for posts the authenticated
member can access. Company Page analytics are not currently supported.
TikTok analytics use the TikTok video query API and require a final TikTok video
ID. Targets that only have the asynchronous Content Posting API publish_id
return syncStatus: "unavailable" until a final video ID is stored.
Google Business performance and search keyword analytics remain available at
/v1/analytics/googlebusiness/performance and
/v1/analytics/googlebusiness/search-keywords.