> ## Documentation Index
> Fetch the complete documentation index at: https://kavenio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics

Use `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.

```http theme={null}
GET /v1/analytics?postId=cccccccccccccccc
```

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

```http theme={null}
GET /v1/analytics?platform=bluesky&limit=25&sortBy=likes&order=desc
```

## Metrics

The normalized metric object includes `likes`, `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`.