Zernio API Docs

Appearance

Get Instagram insights ​

Returns account-level Instagram insights such as reach, views, accounts engaged, and total interactions. These metrics reflect the entire account's performance across all content surfaces (feed, stories, explore, profile), and are fundamentally different from post-level metrics. Data may be delayed up to 48 hours. Max 90 days, defaults to last 30 days. Requires the Analytics add-on.

GET /v1/analytics/instagram/account-insights ​

Returns account-level Instagram insights such as reach, views, accounts engaged, and total interactions. These metrics reflect the entire account's performance across all content surfaces (feed, stories, explore, profile), and are fundamentally different from post-level metrics. Data may be delayed up to 48 hours. Max 90 days, defaults to last 30 days. Requires the Analytics add-on.

Parameters ​

  • accountId (query, string) required — The Zernio SocialAccount ID for the Instagram account

  • metrics (query, string) — Comma-separated list of metrics. Defaults to "reach,views,accounts_engaged,total_interactions". Valid metrics: reach, views, accounts_engaged, total_interactions, comments, likes, saves, shares, replies, reposts, follows_and_unfollows, profile_links_...

  • since (query, string) — Start date (YYYY-MM-DD). Defaults to 30 days ago.

  • until (query, string) — End date (YYYY-MM-DD). Defaults to today.

  • metricType (query, string) — "total_value" (default) returns aggregated totals and supports breakdowns. "time_series" returns daily values but only works with the "reach" metric.

  • breakdown (query, string) — Breakdown dimension (only valid with metricType=total_value). Valid values depend on the metric: media_product_type, follow_type, follower_type, contact_button_type.

Responses ​

200 — Account insights data

  • success (boolean)
  • accountId (string) — The Zernio SocialAccount ID
  • platform (string) (enum: facebook, instagram, youtube, linkedin, tiktok) — Platform that served this response.
  • dateRange (object)
  • metricType (string) (enum: time_series, total_value)
  • breakdown (string) — Breakdown dimension used (only present when breakdown was requested)
  • metrics (object) — Object keyed by metric name. For time_series: each metric has "total" (number) and "values" (array of {date, value}). For total_value: each metric has "total" (number) and optionally "breakdowns" (arr...
  • dataDelay (string)

400 — Bad request (invalid parameters)

  • 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 — Access denied to this account

  • error (string)

404 — Account not found

  • error (string)