Zernio API Docs

Appearance

Get LinkedIn organization page aggregate analytics ​

Returns aggregate analytics for a LinkedIn organization page. Parallel to /v1/accounts/{id}/linkedin-aggregate-analytics (which handles personal accounts only). Backed by LinkedIn's organizationalEntityShareStatistics, organizationalEntityFollowerStatistics, and organizationPageStatistics endpoints.

Response shape matches /v1/analytics/instagram/account-insights. Max 89 days, defaults to last 30 days. Requires the Analytics add-on.

Scope requirements: r_organization_social, r_organization_followers, and r_organization_admin must all be present on the account. Accounts connected before these scopes were included in the OAuth flow will return 412 with a reauth hint.

Enforced by this endpoint:

  • Page-view metrics accept only metricType=total_value (LinkedIn omits per-day segmentation even when the API is called with DAY granularity, so a time-series response would be meaningless).
  • Date range capped at 89 days.

LinkedIn-side platform limits (not re-enforced here, but worth knowing for larger ranges in a future release):

  • Follower stats: rolling 12-month window, end must be no later than 2 days ago.
  • Share stats: rolling 12-month window.

GET /v1/analytics/linkedin/org-aggregate-analytics ​

Returns aggregate analytics for a LinkedIn organization page. Parallel to /v1/accounts/{id}/linkedin-aggregate-analytics (which handles personal accounts only). Backed by LinkedIn's organizationalEntityShareStatistics, organizationalEntityFollowerStatistics, and organizationPageStatistics endpoints.

Response shape matches /v1/analytics/instagram/account-insights. Max 89 days, defaults to last 30 days. Requires the Analytics add-on.

Scope requirements: r_organization_social, r_organization_followers, and r_organization_admin must all be present on the account. Accounts connected before these scopes were included in the OAuth flow will return 412 with a reauth hint.

Enforced by this endpoint:

  • Page-view metrics accept only metricType=total_value (LinkedIn omits per-day segmentation even when the API is called with DAY granularity, so a time-series response would be meaningless).
  • Date range capped at 89 days.

LinkedIn-side platform limits (not re-enforced here, but worth knowing for larger ranges in a future release):

  • Follower stats: rolling 12-month window, end must be no later than 2 days ago.
  • Share stats: rolling 12-month window.

Parameters ​

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

  • metrics (query, string) — Comma-separated list. Defaults to "impressions,clicks,engagement_rate,organic_followers_gained,followers_gained,followers_lost". Share statistics (support both total_value and time_series): - impressions - unique_impressions - clicks - likes...

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

Responses ​

200 — Organization analytics 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. Common cases:

  • Account is a personal LinkedIn account, not organization (code personal_account_not_supported, use /v1/accounts/{id}/linkedin-aggregate-analytics instead)
  • Invalid metric name, metricType, or date range

401

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

403 — Platform error. The authenticated member lacks the required ADMINISTRATOR role on the organization. LinkedIn enforces admin-only access for all three org statistics endpoints. The error envelope is type platform_error, and the raw LinkedIn error is echoed in the platformError field.

404 — Account not found

412 — Missing LinkedIn organization analytics scopes (r_organization_social + r_organization_followers + r_organization_admin)