---
title: "Get post analytics timeline"
method: GET
path: "/v1/analytics/post-timeline"
tags: ["Analytics"]
---

# Get post analytics timeline

`GET /v1/analytics/post-timeline`

Returns a daily timeline of analytics metrics for a specific post, showing how impressions, likes,
and other metrics evolved day-by-day since publishing. Each row represents one day of data per platform.
For multi-platform Zernio posts, returns separate rows for each platform. Requires the Analytics add-on.

## Query parameters

- `postId` string, required
- `fromDate` string, date-time
- `toDate` string, date-time

## Response `200`

Daily analytics timeline

- object
  - `postId` string — The postId that was requested
  - `timeline` object[]
    - `date` string, date — Date in YYYY-MM-DD format
    - `platform` string — Platform name (e.g. instagram, tiktok)
    - `platformPostId` string — Platform-specific post ID
    - `impressions` integer — Total impressions on this date
    - `reach` integer — Total reach on this date
    - `likes` integer — Total likes on this date
    - `comments` integer — Total comments on this date
    - `shares` integer — Total shares on this date
    - `saves` integer — Total saves on this date
    - `clicks` integer — Total clicks on this date
    - `views` integer — Total views on this date
    - `follows` integer — Follows attributed to the post on this date (Instagram feed and stories, TikTok business lane); 0 elsewhere
    - `completionRate` number — TikTok business lane: share of viewers who watched to the end on this date, 0 to 1; 0 elsewhere
    - `profileViews` integer — TikTok business lane: profile views attributed to the post on this date; 0 elsewhere
    - `websiteClicks` integer — TikTok business lane: website-link clicks attributed to the post on this date (also inside clicks); 0 elsewhere
    - `impressionSources` object — TikTok business lane: share of views by surface on this date (forYou, follow, search, personalProfile, sound, directMessage, other), fractions 0 to 1; empty object elsewhere
    - `audienceTypes` object — TikTok business lane: follower / nonFollower and newViewer / returnViewer shares on this date, fractions 0 to 1; empty object elsewhere

## Other responses

- `400` — Missing required postId parameter
- `401` — Unauthorized
- `402` — Analytics access required. Legacy plans need the Analytics add-on; included by default on usage-based plans.
- `403` — Forbidden (post belongs to another user or API key scope violation)
- `404` — Post not found

## Changes

- **2026-09-17** `be448f13ecdc` — 6 info
  - added the optional property `timeline/items/audienceTypes` to the response with the `200` status
  - added the optional property `timeline/items/completionRate` to the response with the `200` status
  - added the optional property `timeline/items/follows` to the response with the `200` status
  - added the optional property `timeline/items/impressionSources` to the response with the `200` status
  - …2 more

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/analytics/post-timeline/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/fdaf9a9fb1a7?raw)