Zernio API Docs

Appearance

Get Instagram follower history ​

Returns a daily running Instagram follower count time series, served from Zernio's cross-platform daily snapshotter. Exists because Meta removed follower_count from the /insights endpoint in Graph API v22+ and never exposed a historical daily series via any public API.

Response envelope matches /v1/analytics/instagram/account-insights so the same client handling works. Max 89 days, defaults to last 30 days. Requires the Analytics add-on.

GET /v1/analytics/instagram/follower-history ​

Returns a daily running Instagram follower count time series, served from Zernio's cross-platform daily snapshotter. Exists because Meta removed follower_count from the /insights endpoint in Graph API v22+ and never exposed a historical daily series via any public API.

Response envelope matches /v1/analytics/instagram/account-insights so the same client handling works. Max 89 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. Defaults to "follower_count,followers_gained,followers_lost". - follower_count : per-day raw follower count - followers_gained : sum of positive daily deltas - followers_lost : sum of absolute negative daily deltas

  • 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" returns aggregated totals (latest for follower_count, sum for gained/lost). "time_series" returns per-day values in the "values" array.

Responses ​

200 — Follower history 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 accountId / metrics / date range, or account is not an Instagram account)

401

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

404 — Account not found