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

## 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

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/f81ca70ea6b9/schema)