Sign in

v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Analytics

Get LinkedIn org 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

Query parameters

accountIdstring required

The Zernio SocialAccount ID for the LinkedIn organization account.

metricsstring

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
  • comments
  • shares
  • engagement_rate (0..1, LinkedIn-computed)

Follower-gain statistics (support total_value and time_series):

  • organic_followers_gained (per-day organic gains for time_series; sum of organic gains over the range for total_value)
  • paid_followers_gained (per-day paid gains for time_series; sum of paid gains over the range for total_value)

Page-view statistics (total_value ONLY - LinkedIn platform limit):

  • page_views_total
  • page_views_overview
  • page_views_careers
  • page_views_jobs
  • page_views_life

Zernio-synthesized from daily follower snapshots:

  • followers_gained
  • followers_lost
sincestring date

Start date (YYYY-MM-DD). Defaults to 30 days ago.

untilstring date

End date (YYYY-MM-DD). Defaults to today.

metricType'time_series' | 'total_value'

Response

Organization analytics data

successboolean
accountIdstring

The Zernio SocialAccount ID

platform'facebook' | 'instagram' | 'youtube' | 'linkedin' | 'tiktok'

Platform that served this response.

metricType'time_series' | 'total_value'
breakdownstring

Breakdown dimension used (only present when breakdown was requested)

metricsobject

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" (array of {dimension, value}).

Monetary metrics additionally carry "unit" and "currency". Zernio never rescales money: "total" and every "values[].value" are the platform's raw numbers in the stated unit. Monetary metrics also keep "values" on metricType=total_value, because their "total" is the sum of the daily buckets the platform returned over the range: keep the series so you can reconcile that sum against the platform's own reporting before invoicing on it. A metric that could not be served is absent from this object and listed in "unavailableMetrics" instead, so an unavailable metric is never reported as a zero.

dataDelaystring

Example response

{
  "success": true,
  "dataDelay": "Data may be delayed up to 48 hours"
}