> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/marketing/linkedin-public-data.md).

# LinkedIn Company Pages

Export LinkedIn Company Pages analytics including followers, engagement, and post performance to Google Sheets or data warehouses via Coupler.io.

LinkedIn Company Pages gives you access to detailed analytics about your company's LinkedIn presence. You can export page performance metrics, follower insights, post analytics, and demographic data directly to your spreadsheet, data warehouse, or BI tool — no coding required.

## Why connect to Coupler.io?

* **Automate your reporting** — Pull fresh LinkedIn analytics on a schedule without manual exports
* **Combine with other data** — Join LinkedIn metrics with CRM, sales, or advertising data for a complete view
* **Multiple report types** — Choose from page performance, follower trends, post analytics, video insights, and demographic breakdowns
* **Send to any destination** — Export to Google Sheets, Excel, BigQuery, Looker Studio, Claude, ChatGPT, and more

## Prerequisites

* A LinkedIn Company Page you manage or have analytics access to
* Admin or Editor role on the page
* Coupler.io account

## Quick start

{% hint style="success" %}
LinkedIn Company Pages works best when you're tracking multiple reports over time. Start with one report type (like "Page: performance insights") to understand the data, then add more as you build out your reporting dashboard.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Sign in to Coupler.io** and create a new data flow. Search for "LinkedIn Company Pages" and select it as your source.
{% endstep %}

{% step %}
**Authorize LinkedIn** — You'll be redirected to LinkedIn to sign in and grant Coupler.io permission to access your Company Page analytics. Make sure you're signed into the LinkedIn account that manages your company page.
{% endstep %}

{% step %}
**Select your LinkedIn Company Page(s)** — Choose which page(s) you want to pull data from. You can select multiple pages if you manage more than one.
{% endstep %}

{% step %}
**Choose a report type** — Select the type of data you want to export:

* **Page: lifetime overview** — Total followers, page visits, and engagement (no date range needed)
* **Page: performance insights** — Daily/weekly engagement metrics like views, clicks, impressions
* **Page: cumulative posts performance** — Combined stats for all posts on the page
* **Page: follower gains trend** — How your follower count changed over time
* **Page: follower demographics insights** — Who your followers are (by location, job title, industry, etc.)
* **Page: audience demographics insights** — Who viewed your page (by location, job title, industry, etc.)
* **Post: individual posts performance** — Metrics for each post (views, clicks, reactions, comments)
* **Post: video performance** — Video-specific metrics (views, viewers, watch time)
* **Post: social reactions & comments count** — Reaction and comment counts for each post
  {% endstep %}

{% step %}
**Set date range (if needed)** — For time-based reports, use the date picker to specify your start and end dates. Lifetime overview reports don't require dates.
{% endstep %}

{% step %}
**Choose dimensions (optional)** — For demographic reports, select how you want to break down the data (by location, job title, industry, etc.).
{% endstep %}

{% step %}
**Select your destination** — Choose where your data goes: Google Sheets, Excel, BigQuery, Looker Studio, Claude, ChatGPT, Cursor, Gemini, Perplexity, OpenClaw, or another platform.
{% endstep %}

{% step %}
**Run the data flow** — Click "Run" to execute your first pull. Monitor the run status to ensure it completes successfully.
{% endstep %}
{% endstepper %}

## LinkedIn Company Pages data overview

LinkedIn Company Pages provides nine main report types, each designed for different analytics needs. Some reports show lifetime totals, while others track changes over time with date ranges.

## Report types

| Report Type                        | Best for                          | Typical use                          |
| ---------------------------------- | --------------------------------- | ------------------------------------ |
| Page: lifetime overview            | Understanding overall page health | High-level page performance tracking |
| Page: performance insights         | Tracking engagement trends        | Weekly/monthly performance reviews   |
| Page: cumulative posts performance | Post strategy effectiveness       | Evaluating all-time post impact      |
| Page: follower gains trend         | Growth tracking                   | Monitoring follower acquisition      |
| Page: follower demographics        | Audience understanding            | HR, recruitment, employer branding   |
| Page: audience demographics        | Visitor insights                  | Content strategy, targeting          |
| Post: individual posts performance | Content analysis                  | Identifying top-performing content   |
| Post: video performance            | Video strategy                    | Measuring video engagement           |
| Post: social reactions & comments  | Community engagement              | Understanding audience sentiment     |

## Page metrics

#### Engagement metrics

| Metric          | Description                                                                     |
| --------------- | ------------------------------------------------------------------------------- |
| Views           | Total number of times your page was viewed                                      |
| Visitors        | Unique users who viewed your page                                               |
| Impressions     | Total times your content appeared (includes page views, post impressions, etc.) |
| Clicks          | Total clicks on your page or content                                            |
| Engagement rate | Percentage of viewers who engaged (clicked, commented, reacted)                 |

#### Follower metrics

| Metric         | Description                        |
| -------------- | ---------------------------------- |
| Followers      | Total follower count               |
| New followers  | New followers gained in the period |
| Lost followers | Followers lost in the period       |
| Net followers  | New followers minus lost followers |

#### Search metrics

| Metric             | Description                                         |
| ------------------ | --------------------------------------------------- |
| Search appearances | Times your page appeared in LinkedIn search results |
| Search clicks      | Clicks from search results to your page             |

## Post metrics

#### Post engagement

| Metric      | Description                               |
| ----------- | ----------------------------------------- |
| Views       | Total times the post was viewed           |
| Clicks      | Total clicks on the post or its content   |
| Reactions   | Total reactions (likes, celebrates, etc.) |
| Comments    | Total comments on the post                |
| Shares      | Total times the post was shared           |
| Impressions | Total times the post was shown in feeds   |

#### Video-specific metrics

| Metric                     | Description                        |
| -------------------------- | ---------------------------------- |
| Views                      | Total video views                  |
| Viewers                    | Unique users who watched the video |
| Time viewed (ms)           | Total watch time in milliseconds   |
| Time viewed for views (ms) | Average watch time per view        |

#### Social reactions & comments

| Metric    | Description                 |
| --------- | --------------------------- |
| Reactions | Total reactions on the post |
| Comments  | Total comments on the post  |

## Demographic dimensions

#### Follower demographics

Break down follower insights by:

* **Geography** — Country, region, city
* **Job title** — Job function and seniority level
* **Industry** — Member's industry
* **Seniority** — C-level, director, manager, entry-level, etc.
* **Company size** — Number of employees
* **School** — Where followers studied

#### Audience demographics

Break down page visitor insights by:

* **Geography** — Country, region, city
* **Job title** — Job function and seniority level
* **Industry** — Member's industry
* **Seniority** — C-level, director, manager, entry-level, etc.
* **Company size** — Number of employees
* **School** — Where visitors studied

## Time-based report dimensions

When splitting performance data by period, you can choose:

* **Daily** — Day-by-day breakdown
* **Weekly** — Week-by-week breakdown
* **Monthly** — Month-by-month breakdown

## Common report combinations

**Content strategy** — Combine "Post: individual posts performance" with "Post: video performance" to compare organic video engagement against all post types.

**Growth analysis** — Use "Page: follower gains trend" and "Page: audience demographics" together to understand who's following you and where growth is coming from.

**Engagement tracking** — Pair "Page: performance insights" (daily views) with "Post: individual posts performance" to see how specific posts drive overall page activity.

**Recruitment/employer branding** — Combine "Page: follower demographics" and "Page: audience demographics" to understand your recruiting audience by job title, seniority, and industry.

## Use cases by role

{% tabs %}
{% tab title="Marketing & Content Teams" %}
**Track content performance and audience engagement**

Use "Post: individual posts performance" and "Post: video performance" to identify your best-performing content. Export to Google Sheets or Looker Studio to build a content performance dashboard. Pair with engagement metrics to refine your posting strategy.

Combine "Page: performance insights" with post data to correlate specific posts with page-level engagement spikes.
{% endtab %}

{% tab title="Recruiting & HR" %}
**Understand your recruitment audience**

Use "Page: follower demographics" and "Page: audience demographics" to see who's interested in your company. Break down by job title and seniority to understand your recruiting reach. Export to BigQuery or Google Sheets for further analysis.

Track "Page: follower gains trend" to measure the impact of recruitment campaigns on your page growth.
{% endtab %}

{% tab title="Social Media Managers" %}
**Monitor page health and growth**

Use "Page: lifetime overview" for quick snapshots and "Page: follower gains trend" for growth tracking. Export "Page: performance insights" daily to monitor engagement patterns.

Set up multiple data flows for different report types and consolidate in Looker Studio or Google Sheets for a unified social dashboard.
{% endtab %}

{% tab title="Business Intelligence & Analytics" %}
**Build comprehensive social analytics**

Export all report types to BigQuery to build a historical archive. Combine LinkedIn data with CRM, advertising, and sales data using Coupler.io's Join transformation.

Create demographic cross-tabs by combining "Page: audience demographics" dimensions with multiple pages to compare audience composition.
{% endtab %}
{% endtabs %}

## Platform-specific notes

* **Date ranges** — Some reports (like "Page: performance insights") require date ranges; others (like "Page: lifetime overview") are snapshots with no date requirement.
* **Demographic breakdowns** — Follower and audience demographic reports can be split by multiple dimensions (geography, job title, industry). Choose one dimension per report.
* **Video metrics** — Video performance reports require a date range and show watch time data specific to video content.
* **Post-level data** — Individual post reports do not require dates; they pull all posts on your page (or within a selected date range if available).
* **Deprecated reports** — Some older report types ("Posts: UGC posts insights", "Page: shares lifetime overview", "Time-based", "Lifetime total statistic") are deprecated and should not be used for new flows.

## LinkedIn Company Pages common issues

### Connection issues

<details>

<summary>LinkedIn authorization fails or redirects incorrectly</summary>

Make sure you're signed into the correct LinkedIn account (the one that manages your company page). If you have multiple LinkedIn accounts, sign out of the others first, then try authorizing again.

If you're still having trouble, try:

* Clearing your browser cookies for LinkedIn.com
* Using a different browser or incognito window
* Ensuring you have Editor or Admin permissions on the company page

</details>

<details>

<summary>Company page doesn't appear in the page selector</summary>

Your page may not show up if:

* You don't have Editor or Admin role on the page
* The page was recently created (LinkedIn may need time to sync it)
* You're signed into a personal account that doesn't manage the page

Verify your access level in LinkedIn by visiting the page and checking the "Admin tools" menu. You need at least Editor permissions to export analytics.

</details>

<details>

<summary>"Access Denied" error when trying to run the flow</summary>

{% hint style="warning" %}
This typically means your LinkedIn permission level changed after you authorized Coupler.io.
{% endhint %}

Solutions:

* Check your company page role in LinkedIn (it may have been downgraded)
* Re-authorize Coupler.io with your LinkedIn account
* Ensure your LinkedIn account is still active on the page

</details>

### Missing data

<details>

<summary>Post data not appearing in the export</summary>

For "Post: individual posts performance" reports, LinkedIn only includes posts from the last 2 years. Older posts won't appear.

Also verify:

* Your date range (if specified) includes recent posts
* The page actually has posts published in that period
* You're not filtering out deleted or archived posts

If you're still missing data, check the data preview before running the full flow to see what's being pulled.

</details>

<details>

<summary>Follower count or demographics showing incomplete data</summary>

Demographic insights (follower demographics, audience demographics) only include members with complete LinkedIn profiles. LinkedIn doesn't provide demographic data for private or minimal profile members.

Also note:

* "Page: lifetime overview" shows all followers, but demographics reports only break down profiled users
* Some geographic regions may have small sample sizes and won't appear in results
* Job title and seniority data depends on member profile completeness

</details>

<details>

<summary>Null or blank values in the export</summary>

{% hint style="danger" %}
This is a known issue when certain report types return metrics that aren't available for your page or time period.
{% endhint %}

Common causes:

* Selecting metrics not available for your chosen report type
* Demographic dimensions with no data (e.g., very few followers in a region)
* Time periods with zero engagement

Try:

* Checking your data preview before running the full flow
* Starting with a simpler report type (like "Page: lifetime overview")
* Extending your date range to capture more data

</details>

<details>

<summary>Video metrics showing zero or incomplete data</summary>

Video performance data is only available if your company page has published native LinkedIn video posts (not links to external videos). Text and image posts won't have video metrics.

Also:

* Set a date range that includes your video posts
* LinkedIn only tracks video metrics for videos published in the last 2 years
* Private or restricted videos may not be included

</details>

### Permission errors

<details>

<summary>"Requested version 20240101 is not active" error</summary>

{% hint style="warning" %}
This error occurs when LinkedIn's API version changes. It's usually temporary and resolves on LinkedIn's side.
{% endhint %}

What to do:

* Wait a few hours and try again
* Check LinkedIn's API status page for announcements
* If the error persists after 24 hours, contact Coupler.io support

Your data flow may be temporarily disabled during LinkedIn API updates. Re-enable it once the error clears.

</details>

<details>

<summary>"Service Unavailable" (503) error</summary>

LinkedIn's API is temporarily down or overloaded. This usually clears within an hour.

Try:

* Waiting 30 minutes and running again
* Checking LinkedIn's status page
* Running during off-peak hours (outside 9 AM–5 PM in your region)

Do not run the flow repeatedly while the error persists — it will increase quota usage.

</details>

<details>

<summary>426 error or "API version not supported"</summary>

{% hint style="danger" %}
This indicates a breaking change in LinkedIn's API that affects your data flow.
{% endhint %}

This usually means:

* LinkedIn deprecated the report type you're using
* Your account was moved to a new API version

Contact Coupler.io support if this occurs — we may need to update the connector.

</details>

### Data discrepancies

<details>

<summary>Exported data doesn't match LinkedIn's analytics dashboard</summary>

Small differences (1–5%) are normal due to:

* **Time zone differences** — LinkedIn reports in the viewer's time zone; Coupler.io may use UTC
* **Real-time vs. historical data** — LinkedIn's dashboard is updated in real-time; exported data may be 6–12 hours behind
* **Rounding** — LinkedIn displays rounded metrics; raw API data may differ slightly
* **Filtering** — Your dashboard may apply filters not reflected in the raw export

Larger discrepancies (>10%):

* Check your date range — make sure it matches LinkedIn's dashboard
* Verify you're comparing the same report type
* Check if LinkedIn made changes to the metrics definition

</details>

<details>

<summary>Post performance metrics changing after export</summary>

LinkedIn post metrics continue to accrue after publication. If you pull post data on day 1, then pull again on day 7, the numbers will be higher.

This is expected behavior. To track historical snapshots:

* Pull the data regularly on a schedule
* Archive each export with a date stamp
* Use append mode to build a historical time series in your destination

</details>

<details>

<summary>Demographic percentages don't add up to 100%</summary>

Demographic data is based on incomplete profile information from LinkedIn members. Not all followers provide complete job title, seniority, or geographic data.

The percentages shown represent only profiled members, so the total may be significantly less than 100% if many followers have incomplete profiles.

</details>

### Rate limits

<details>

<summary>Getting throttled after multiple runs</summary>

LinkedIn enforces rate limits on analytics API calls. If you run the same flow too many times in a short period, requests may be delayed or rejected.

Best practices:

* Avoid running the same flow manually multiple times per day
* Use scheduled runs instead (e.g., daily or weekly)
* Space out manual test runs by at least 15 minutes
* If you need frequent updates, use a longer date range rather than daily snapshots

</details>

<details>

<summary>"Too many requests" error</summary>

You've hit LinkedIn's rate limit. Wait at least 1 hour before running the flow again.

To prevent this:

* Schedule your data flows rather than running manually
* Avoid running multiple LinkedIn flows simultaneously
* Use weekly or monthly runs instead of daily if possible

</details>

## LinkedIn Company Pages FAQ

<details>

<summary>What's the difference between "Page: lifetime overview" and "Page: performance insights"?</summary>

**Page: lifetime overview** gives you a one-time snapshot of total followers, page views, and engagement since your page was created. No date range needed — it's a cumulative total.

**Page: performance insights** shows daily or weekly engagement metrics (views, clicks, impressions) broken down by time. You need a date range, and it's useful for tracking trends and seasonality.

Use lifetime overview for a quick health check; use performance insights to understand trends over time.

</details>

<details>

<summary>Can I export data for multiple company pages in one flow?</summary>

Yes. In the "Pages" step, select all the pages you want to include. The exported data will have one row per page with combined metrics. If you need page-specific breakdowns, create separate flows for each page and use Append to combine them.

</details>

<details>

<summary>How far back can I pull data?</summary>

It depends on the report type:

* **Page metrics** — Up to 2 years of historical data
* **Post metrics** — Only posts published in the last 2 years
* **Demographic reports** — No date range; they're current snapshots

For older data, you'll need to pull from LinkedIn's analytics dashboard manually.

</details>

<details>

<summary>What if I need real-time data?</summary>

{% hint style="info" %}
See the "Data refresh and scheduling" section in Best Practices for recommended refresh frequencies.
{% endhint %}

LinkedIn's analytics API updates with a 6–12 hour delay. There's no way to get true real-time data. Schedule your flows for daily or multiple times per day if you need near-current data, but be aware of rate limits.

</details>

<details>

<summary>Can I join LinkedIn data with other sources?</summary>

Yes. Use Coupler.io's Join transformation to combine LinkedIn data with your CRM, advertising platform, or sales data. For example, join post performance with advertising spend by date to measure ROI.

{% hint style="info" %}
See the "Transformations" section in the Coupler.io docs for detailed Join setup.
{% endhint %}

</details>

<details>

<summary>Why are some demographic metrics showing as null or blank?</summary>

Demographic data is based on LinkedIn member profiles. If most of your followers or visitors don't provide complete job title, seniority, or geographic information, those fields will show as missing.

Try:

* Checking the data preview before running
* Using a different demographic dimension (e.g., geography instead of job title)
* Ensuring your page has enough engaged followers to generate meaningful demographic data

</details>

<details>

<summary>How do I track post performance over time?</summary>

Create a data flow with "Post: individual posts performance" set to append (not replace) your destination. Run it on a weekly schedule. Over time, you'll build a historical record showing how engagement on each post accumulates.

You can then use that data to find your best-performing posts by total engagement.

</details>

<details>

<summary>What's the difference between "Views" and "Impressions"?</summary>

**Views** — Times your page or content was explicitly opened or clicked on.

**Impressions** — Total times your content appeared in someone's feed (whether they clicked or not).

Impression rates are typically higher because they include passive views.

</details>

<details>

<summary>Can I export video performance separately from other posts?</summary>

Yes. Create a separate data flow with "Post: video performance" to pull video-specific metrics (views, viewers, watch time). Use this alongside "Post: individual posts performance" to compare video engagement.

Note: LinkedIn only tracks these metrics for native video posts, not links to external videos.

</details>

<details>

<summary>My data flow keeps failing. What should I check?</summary>

1. Verify your LinkedIn permissions (Editor or Admin on the page)
2. Check the error message in the run log
3. Try the data preview to see if the issue is with the configuration
4. Re-authorize your LinkedIn account if permissions changed
5. Check if LinkedIn's API is having issues (wait 30 minutes and retry)

{% hint style="info" %}
See the "Common Issues" article for specific error codes and solutions.
{% endhint %}

</details>

<details>

<summary>How do I set up a dashboard in Google Sheets or Data Studio?</summary>

Export your LinkedIn data to Google Sheets or BigQuery, then create a dashboard in Data Studio that references that data. Use multiple sheets (one per report type) and link them with report filters.

For example:

* One sheet with daily performance metrics
* One sheet with top posts
* One sheet with demographic breakdown

Then create a Data Studio dashboard with cards showing key metrics and trend charts.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.coupler.io/sources/category/marketing/linkedin-public-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
