Get post analytics 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.

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.

Parameters

• postId (query, string) required — The post to fetch timeline for. Accepts an ExternalPost ID, a platformPostId, or a Zernio Post ID.

• fromDate (query, string) — Start of date range (ISO 8601). Defaults to 90 days ago.

• toDate (query, string) — End of date range (ISO 8601). Defaults to now.

Responses

200 — Daily analytics timeline

• postId (string) — The postId that was requested
• timeline (array)

400 — Missing required postId parameter

• error (string)

401

402 — Analytics access required. Legacy plans need the Analytics add-on; included by default on usage-based plans.

• error (string)
• code (string)

403 — Forbidden (post belongs to another user or API key scope violation)

• error (string)

404 — Post not found

• error (string)