> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data reference

> Metrics, breakdowns, refresh cadence, and limits for the LinkedIn Organic data source in Adriel.

## 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-sources/g-n/linkedin-organic/how-to-connect).

## 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

<Note>
  **How to read the columns**

  **Data 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.
</Note>

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

<Note>
  These groupings are provided by Adriel rather than returned by LinkedIn.
</Note>

| 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

<Note>
  Adriel aggregates LinkedIn's underlying daily records into these time views for reporting.
</Note>

| 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](https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/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](https://learn.microsoft.com/en-us/linkedin/marketing/)

## See also

* [How to connect LinkedIn Organic to Adriel](/data-sources/g-n/linkedin-organic/how-to-connect) (paired how-to)
* [LinkedIn Ads data reference](/data-sources/g-n/linkedin-ads/data-reference) — for paid LinkedIn campaigns
* [Facebook Page Organic data reference](/data-sources/a-f/facebook-page-organic/data-reference) — sister organic-social platform