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.
Authorization
bearerAuth API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
In: header
Query Parameters
The Zernio SocialAccount ID for the LinkedIn organization account.
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
Start date (YYYY-MM-DD). Defaults to 30 days ago.
dateEnd date (YYYY-MM-DD). Defaults to today.
date"total_value"Value in
- "time_series"
- "total_value"
Response Body
application/json
application/json
{ "success": true, "accountId": "string", "platform": "facebook", "dateRange": { "since": "2019-08-24", "until": "2019-08-24" }, "metricType": "time_series", "breakdown": "string", "metrics": { "property1": { "total": 0, "values": [ { "date": "2019-08-24", "value": 0 } ], "breakdowns": [ { "dimension": "string", "value": 0 } ], "unit": "micro_amount", "currency": "string" }, "property2": { "total": 0, "values": [ { "date": "2019-08-24", "value": 0 } ], "breakdowns": [ { "dimension": "string", "value": 0 } ], "unit": "micro_amount", "currency": "string" } }, "unavailableMetrics": [ { "metric": "string", "reason": "not_enrolled", "message": "string" } ], "dataDelay": "string"}Get LinkedIn aggregate stats
Returns aggregate analytics across all posts for a LinkedIn personal account. Only includes posts published through Zernio (LinkedIn API limitation). Org accounts should use /v1/analytics instead. Requires r_member_postAnalytics scope. Saves (POST_SAVE) and sends (POST_SEND) are available for personal accounts; organization pages always return 0 for these two metrics because LinkedIn does not expose them on the organization analytics endpoint.
Get LinkedIn post stats
Returns analytics for a specific LinkedIn post by URN. Works for both personal and organization accounts. Saves and sends are only populated for personal accounts (LinkedIn does not expose these metrics on the organization analytics endpoint).