Analytics

Get an analytics dashboard

Changed on

Everything an analytics dashboard needs in one call: window totals, follower growth, a per-day series, top posts, recent posts and, optionally, the same figures for the previous period.

All dates are UTC days.

Daily and total metrics

Daily and total metrics use received attribution: each day holds the engagement that arrived that day, on any post. So totals is always the sum of daily.

Post lists

topPosts and recentPosts list posts published in the window with their lifetime metrics. A post cross-posted to several platforms appears once per platform.

get/v1/analytics/dashboard

Request

  • Base URL
    https://zernio.com/api
  • Auth
    HTTP bearer

Query parameters

profileIdstring

Profile ID, or "all" for every profile you can access.

platformstring

Platform to cover (e.g. "instagram"), or "all".

fromDatestring date required
Example:2026-09-01

First day of the window (YYYY-MM-DD, inclusive).

toDatestring date required
Example:2026-09-30

Last day of the window (YYYY-MM-DD, inclusive). May equal fromDate. The window covers at most 366 days.

compare'previous_period'

Set to "previous_period" to also return previousTotals and previousFollowers for the window of the same length that ends the day before fromDate.

topPostsinteger

How many top posts to return, ranked by engagement (likes, comments, shares and saves, the same sum as daily engagement).

recentPostsinteger

How many of the most recently published posts to return.

Response

Dashboard for the window

dataAsOfstring date-time nullable required

When the most recently synced account in scope was last synced. Null if none has synced yet.

Changes

    • warning

      added the new account-insights enum value to the / response property for the response status

    • warning

      added the new account_route enum value to the / response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status