LinkedIn reference
LinkedIn analytics API: two post surfaces, and what Postdom has verified
The LinkedIn analytics API splits post metrics across two surfaces: organization pages and member creators. Postdom posts your approved videos to LinkedIn, and is honest about results: it does not report LinkedIn metrics yet, so every field stays null, not zero.
What can the LinkedIn analytics API return through Postdom?
Nothing verified yet. Here is every field Postdom models for LinkedIn, with its recorded state and reason.
| Field | State | What Postdom returns, and why |
|---|---|---|
| ViewsThe view count in a normalized LinkedIn performance snapshot. | Unverified | Postdom has not verified this field's LinkedIn coverage. It stays null, and null is not zero.linkedin.views is unverified; no evidence-backed value is available yet. |
| LikesThe like count in a normalized LinkedIn performance snapshot. | Unverified | Postdom has not verified this field's LinkedIn coverage. It stays null, and null is not zero.linkedin.likes is unverified; no evidence-backed value is available yet. |
| CommentsThe comment count in a normalized LinkedIn performance snapshot. | Unverified | Postdom has not verified this field's LinkedIn coverage. It stays null, and null is not zero.linkedin.comments is unverified; no evidence-backed value is available yet. |
| SharesThe share count in a normalized LinkedIn performance snapshot. | Unverified | Postdom has not verified this field's LinkedIn coverage. It stays null, and null is not zero.linkedin.shares is unverified; no evidence-backed value is available yet. |
| SavesPostdom's saves field. LinkedIn exposes a save count on its member creator surface and not on the enumerated organization schema, so whether an equivalent exists depends on which of the two a post belongs to. | Unverified | Postdom has not verified this field's LinkedIn coverage. It stays null, and null is not zero.linkedin.saves is unverified; no evidence-backed value is available yet. |
| Watch timePostdom's total watch-time field, in seconds. | Unverified | Postdom has not verified this field's LinkedIn coverage. It stays null, and null is not zero.linkedin.watch_time_s is unverified; no evidence-backed value is available yet. |
| Average watch percentagePostdom's average percentage-watched field. | Unverified | Postdom has not verified this field's LinkedIn coverage. It stays null, and null is not zero.linkedin.avg_watch_pct is unverified; no evidence-backed value is available yet. |
| Completion percentagePostdom's completed-view percentage field. | Unverified | Postdom has not verified this field's LinkedIn coverage. It stays null, and null is not zero.linkedin.completion_pct is unverified; no evidence-backed value is available yet. |
| Follower deltaAn account-level follower change field, not exact per-post attribution. | Unverified | Postdom has not verified this field's LinkedIn coverage. It stays null, and null is not zero.linkedin.follower_delta is unverified; no evidence-backed value is available yet. |
No row here carries a verification date, because no row here has been verified. A date on one would be a stamp borrowed from work done for a different destination. The reason text is the same sentence the API returns beside the null value, taken from the record rather than rewritten for the page.
LinkedIn post analytics API: the two surfaces
LinkedIn documents its retrieval contract in full, and it is two contracts. Which one applies depends on whether the post belongs to an organization page or a member creator, and they expose different metrics.
| Surface | Endpoint | Permission | Fields | Retention | Save count? |
|---|---|---|---|---|---|
| Organization page post | organizationalEntityShareStatistics | rw_organization_admin — ADMINISTRATOR only | impressionCount, uniqueImpressionsCount, likeCount, commentCount, shareCount, clickCount, engagement | Returns share data only within the past 12 months, on a rolling window. | No — the ShareStatisticsData schema is enumerated in full at seven fields and has no save field. |
videoAnalytics | r_organization_social — ADMINISTRATOR or DIRECT_SPONSORED_CONTENT_POSTER | VIDEO_VIEW, VIEWER, TIME_WATCHED, TIME_WATCHED_FOR_VIDEO_VIEWS | VIDEO_VIEW, VIEWER and TIME_WATCHED_FOR_VIDEO_VIEWS are unavailable after six months. TIME_WATCHED carries no such statement. | No — this endpoint returns video metrics only. | |
| Member creator post | memberCreatorPostAnalytics | r_member_postAnalytics — “Retrieve your posts and their reporting data.” | IMPRESSION, MEMBERS_REACHED, RESHARE, REACTION, COMMENT, POST_SAVE, POST_SEND, LINK_CLICKS, PREMIUM_CTA_CLICKS, FOLLOWER_GAINED_FROM_CONTENT, PROFILE_VIEW_FROM_CONTENT | This document states no retention limit. That is silence, not a guarantee that the data is kept. | Yes — POST_SAVE, “Number of times the requested entity was saved.” The only LinkedIn endpoint documenting a save count. |
memberCreatorVideoAnalytics | r_member_postAnalytics — “Retrieve your posts and their reporting data.” | VIDEO_PLAY, VIDEO_VIEWER, VIDEO_WATCH_TIME | VIDEO_PLAY and VIDEO_VIEWER are unavailable after one year of post creation. VIDEO_WATCH_TIME carries no such statement. | No — this endpoint returns video metrics only. |
LinkedIn states the mapping directly: the field Watch Time in its interface equals the TIME_WATCHED_FOR_VIDEO_VIEWS type in the API. Each call carries a Linkedin-Version header in YYYYMM form; it is required, not defaulted. These readings are from the current default of LinkedIn's documentation, moniker 202608. The eleven member metric types exist from 202604 onward; earlier versions document five. LinkedIn's sunset notice for version 202508 gives 17 August 2026. Read from LinkedIn’s own documentation on , not from a relay’s platform matrix — a supplier’s claim about itself is not first-party evidence about the platform.
A documented contract is a ceiling on what could arrive, not proof that it does. Postdom reads what its publishing relay hands back, so none of this changes a row above.
LinkedIn video analytics: two kinds of absence
"Not published" is a fact about LinkedIn. "Unverified" is a fact about Postdom. Mixing them up would say either that LinkedIn withholds the data or that Postdom checked and found none. Neither is true.
| State | A fact about | What it asserts | Live example | What would settle it |
|---|---|---|---|---|
| Not published | The reviewed source does not separately state this fact for the specific surface or field. | The Videos API schema has no separate organic/feed duration ceiling. The API page's high-level block says 30 minutes, general sharing says 15 and Pages says 10, so Postdom does not turn one scoped value into an API enforcement rule. | A first-party LinkedIn statement that resolves the surface boundary, or an observed API rejection that pins the real bound. | |
| Unverified | Postdom | Postdom has not established what happens, and says so rather than guessing either way. | Every metric on this page. Nothing has been observed about what comes back for a LinkedIn post published through Postdom. | Three things would each move a row, in increasing order of strength: establishing which of LinkedIn's two surfaces a Postdom post belongs to, reading the relay's own LinkedIn analytics contract at first hand, and observing a real per-platform response. Only the last clears the bar. |
Why the field is null and not zero
Zero is a measurement. Null is the absence of one. A post nobody watched and a post whose views were never observed are different facts.
So an unverified field stays null and is left out of totals and averages. A dashboard that counts it as zero reports a drop that never happened.
LinkedIn analytics API questions
Does Postdom report LinkedIn views or likes?
Not yet. Every LinkedIn metric field is recorded as unverified, so Postdom returns null with a reason instead of a number.
Does LinkedIn's API have post analytics?
Yes, on two surfaces: organization pages and member creators. They use different endpoints and permissions, and only the member surface documents a save count.
Why null instead of zero?
Zero would claim nobody engaged. Null says no value was observed. Keep null values out of averages.
What would change this page?
An observed response from LinkedIn for a post published through Postdom. Until then, the states stay unverified.
Is there a free LinkedIn analytics API?
Not through Postdom yet. Postdom's Free plan has no card and makes 1 post a month on 2 accounts, on any platform, LinkedIn included, but Postdom does not report LinkedIn metrics today: every field stays null with a reason.
LinkedIn's own analytics access depends on its developer programs and permissions. Check LinkedIn's terms for your app.
Post to LinkedIn with Postdom
Postdom turns your website into ready-to-post videos and slideshows in your brand, and posts the ones you approve to TikTok, Instagram and more. You decide what goes out.
Nothing posts until you approve it. Start on Free with no card: 1 post a month on 2 accounts, on any platform, LinkedIn included.
Start free with Postdom
Paste your website and see your first post today.