Data reference - Adriel Knowledge Base

Introduction

LinkedIn Organic surfaces page-level and post-level organic performance for a connected LinkedIn Company Page through the LinkedIn Marketing API. It covers feed posts, articles, documents, and video posts, alongside page-level signals such as follower counts, profile views, and follower geography. LinkedIn Organic targets Company Pages — personal profile metrics are not supported by this connector. The Company Page is captured at connection time (as an Organization URN) and used as the single root for all queries against that connection. As an organic-social connector, engagement metrics, audience breakdowns, and post-level groupings are standardized so widgets can aggregate alongside other sources without additional configuration. To connect this data source, see How to connect LinkedIn Organic to Adriel.

Data refresh strategy

Architecture data

Architecture covers the Company Page and its post hierarchy. On first connection, posts created within the last 365 days are retrieved, but only lifetime metrics are available for them — no historical daily values. Metrics accumulate in the cache from the connection date forward. New posts appear after the next daily refresh at 12:00 AM UTC.

Reports data

Reports include lifetime and daily performance for the page and its posts.

Lifetime page and post data refreshes daily at 12:00 AM UTC.
Daily page data: the initial fetch covers the last 90 days; each subsequent refresh updates the most recent 3 days at 12:00 AM UTC.

Follower and audience metrics have no historical backfill — only daily snapshots are cached from the connection date forward. Associated media may expire if a post is no longer accessible through the API, and delta values for very old posts (3+ years) or posts that became unretrievable (deleted or restricted) are not recorded.

Architecture levels

LinkedIn Company Page → Post (text post / article / document / video)

Date range limits

Some time breakdowns cap the range that can be returned in a single query. Data outside the cap may be truncated.

Breakdown	Max range
Daily	93 days
Weekly	1 year

Metrics

How to read the columnsData type uses this vocabulary: Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean.API Key in code style like impressionCount is the literal LinkedIn REST API field name. Italic text describes how a value is produced when it doesn’t map to a single API field — for example a delta computed from cached daily snapshots.

Most post-level metrics are available in two variants: a lifetime value (cumulative since the post was published) and a period value (the change within the selected reporting range). Lifetime values carry the platform API key; period values are derived by Adriel from cached snapshots.

Followers

Metric	Description	Data type	API Key
Follower count (lifetime)	Cumulative followers of the Company Page.	Number	`firstDegreeSize`
Follower count (period)	Net follower change over the period.	Number	derived from daily snapshots
Organic followers gained	Followers gained organically in the period.	Number	`followerGains.organicFollowerGain`
Paid followers gained	Followers gained through Sponsored Content in the period.	Number	`followerGains.paidFollowerGain`

Reach & impressions

Metric	Description	Data type	API Key
Impressions (page)	Times page content was shown in the period.	Number	`impressionCount`
Reach (page)	Unique members who saw page content in the period.	Number	`uniqueImpressionsCount`
Profile views	Views of the Company Page in the period.	Number	`allPageViews.pageViews`
Post impressions (lifetime)	Times a post has been shown since publication.	Number	`impressionCount`
Post impressions (period)	Times a post was shown during the period.	Number	derived from daily snapshots

Engagement

Page-level engagement for the selected period.

Metric	Description	Data type	API Key
Engagement (page)	Total engagements (reactions, comments, shares, and clicks) on page content in the period.	Number	engagement rate × impressions
Clicks (page)	Clicks on page content in the period.	Number	`clickCount`
Likes (page)	Like reactions on page content in the period.	Number	`likeCount`
Comments (page)	Comments on page content in the period.	Number	`commentCount`
Shares (page)	Shares of page content in the period.	Number	`shareCount`
Posts published	Number of posts published in the period.	Number	derived from post cache

Post-level engagement.

Metric	Description	Data type	API Key
Post engagement (lifetime)	Total engagements on a post since publication.	Number	engagement rate × impressions
Post engagement (period)	Engagements on a post during the period.	Number	derived from daily snapshots
Post likes (lifetime)	Like reactions on a post since publication.	Number	`likeCount`
Post likes (period)	Like reactions on a post during the period.	Number	derived from daily snapshots
Post comments (lifetime)	Comments on a post since publication.	Number	`commentCount`
Post comments (period)	Comments on a post during the period.	Number	derived from daily snapshots
Post shares (lifetime)	Shares of a post since publication.	Number	`shareCount`
Post shares (period)	Shares of a post during the period.	Number	derived from daily snapshots

Post reactions

Reaction-type breakouts for individual posts, available as lifetime and period variants.

Metric	Description	Data type	API Key
Celebrate (lifetime)	“Celebrate” reactions on a post since publication.	Number	`PRAISE`
Celebrate (period)	“Celebrate” reactions on a post during the period.	Number	derived from daily snapshots
Love (lifetime)	“Love” reactions on a post since publication.	Number	`EMPATHY`
Love (period)	“Love” reactions on a post during the period.	Number	derived from daily snapshots
Support (lifetime)	“Support” reactions on a post since publication.	Number	`APPRECIATION`
Support (period)	“Support” reactions on a post during the period.	Number	derived from daily snapshots
Insightful (lifetime)	“Insightful” reactions on a post since publication.	Number	`INTEREST`
Insightful (period)	“Insightful” reactions on a post during the period.	Number	derived from daily snapshots
Curious (lifetime)	“Curious” reactions on a post since publication.	Number	`MAYBE`
Curious (period)	“Curious” reactions on a post during the period.	Number	derived from daily snapshots

Post metadata

Metric	Description	Data type	API Key
Post date	Date the post was published.	Date	`publishedAt`
Post text	Text body of the post.	Text	`commentary`
Post link	URL of the post.	URL	derived from post object
Post media	URL of the post’s attached media.	URL	`downloadUrl`

General

Metric	Description	Data type	API Key
Datasource name	Name of the Adriel data source.	Text	Adriel metadata
Channel	Constant label — always “linkedin”; used for cross-connector rollup.	Text	Adriel-assigned
Number of days per row	Number of days covered by each row.	Number	Adriel date calculation
Remaining days	Days remaining in the selected range.	Number	Adriel date calculation

Breakdowns

Content

Breakdown	Description	API Key
Post	Group by individual post.	`id`
Post date	Group by the post’s publish date.	`publishedAt`
Post text	Group by post text.	`commentary`

Audience

Breakdown	Description	API Key
Country (followers)	Group followers by country.	`defaultLocalizedName.value`

Page & channel

These groupings are provided by Adriel rather than returned by LinkedIn.

Breakdown	Description
Page	Group by Company Page.
Channel	Constant grouping label — always “linkedin”; used for cross-connector rollup.
No Grouping	Return one aggregated row.
Datasource Name	Group by Adriel data source name.

Time & date grouping

Adriel aggregates LinkedIn’s underlying daily records into these time views for reporting.

Breakdown	Description
Auto Time Breakdown	Automatically picks the best granularity for the date range.
Daily	Split reports by day. Limited to a maximum of 93 days.
Weekly (Start: Mon)	Split reports by ISO week, starting Monday. Limited to a maximum of 1 year.
Monthly	Split reports by calendar month.
Quarterly	Split reports by calendar quarter.
Yearly	Split reports by calendar year.

Limitations

Company Pages only — the connector authorizes against a LinkedIn Company Page; personal profile metrics are not exposed.
No follower or audience backfill — follower counts and follower geography have no history; only daily snapshots are cached, accumulating from the connection date forward.
Demographic breakdowns are limited — LinkedIn returns follower demographics only for lifetime (non-time-bound) queries and caps each facet at its top results, so small Company Pages may see empty buckets for less common combinations (LinkedIn follower statistics).
Older and unretrievable posts — delta values for very old posts (3+ years) or posts that became unretrievable (deleted or restricted) are not recorded, and associated media may expire when a post is no longer accessible through the API.
v1 deprecated — this reference covers the v2 connector; the legacy v1 LinkedIn Organic connector is hidden from new-connection flows, and existing v1 widgets continue to function.

API references

LinkedIn REST API version 202510 (sent as the Linkedin-Version header on every request).
Page and post statistics: organizationalEntityShareStatistics.
Follower gains: organizationalEntityFollowerStatistics.
Profile views: organizationPageStatistics.
Lifetime follower count: networkSizes/{organization} (with edgeType=COMPANY_FOLLOWED_BY_MEMBER).
Follower geography: geo / country follower endpoint.
LinkedIn Marketing API documentation

​Introduction

​Data refresh strategy

​Architecture data

​Reports data

​Architecture levels

​Date range limits

​Metrics

​Followers

​Reach & impressions

​Engagement

​Post reactions

​Post metadata

​General

​Breakdowns

​Content

​Audience

​Page & channel

​Time & date grouping

​Limitations

​API references

​See also

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Followers

Reach & impressions

Engagement

Post reactions

Post metadata

General

Breakdowns

Content

Audience

Page & channel

Time & date grouping

Limitations

API references

See also