LinkedIn Analytics API
The LinkedIn Analytics API brings LinkedIn Company Page performance data into a product, reporting workflow, automation, or AI system through one API.
curl -X GET "{{API_BASE_URL}}/v1/analytics?source=platform&platform=linkedin&accountId=acc_li_org_456&limit=10&page=1" \
-H "x-access-key: your-api-key"curl -X GET "{{API_BASE_URL}}/v1/analytics?source=platform&platform=linkedin&accountId=acc_li_org_456&limit…
-H "x-access-key: your-api-key"
It returns post-level impressions, unique reach, likes, comments, shares, clicks, and engagementRate for supported Company Page posts, including existing posts retrieved with source=platform, filtered by date range and paginated for dashboards and reports.
What the LinkedIn Analytics API returns for Company Page posts
The LinkedIn Analytics API is scoped to LinkedIn Company Page posts. For each supported post it returns impressions, unique reach, likes, comments, shares, clicks, and engagementRate, identified by platformPostId and accountId with a collectedAt timestamp. Unique reach is distinct from impressions: impressions count total views, while reach counts unique people reached. Clicks provide traffic attribution by tracking how many people clicked through from a LinkedIn post. Engagement rate is calculated from likes, comments, shares, and clicks relative to impressions, so a post with strong clicks but low likes can still show meaningful engagement when impressions are the denominator.
Scope: Company Page only, existing posts, and OAuth and token management
Retrieve analytics for a specific Company Page by using the integration ID for the connected Company Page as accountId. To include existing Company Page posts that were not published through the API, use source=platform together with platform=linkedin. Personal-profile posts are not supported by current LinkedIn analytics; treat a personal-profile accountId as an unsupported scope and check the returned data rather than assuming personal-profile metrics will appear. OAuth and token management are handled through the connected integration, so the caller does not manage LinkedIn OAuth tokens directly.
Date range filtering up to 366 days
Use fromDate and toDate to filter post analytics by date range and find the best-performing content over a reporting period of up to 366 days. Keep the requested range within 366 days and paginate with limit and page while checking pagination total and totalPages before concluding that a report is complete. Sort or rank results in your own reporting layer by impressions, unique reach, clicks, or engagementRate depending on whether the question is about audience size, traffic, or interaction quality.
Worked example and implementation checklist
The worked request and response examples below show the exact request contract and the exact response shape for Company Page posts. The captured example for GET /v1/analytics shows a 202 response, and that status is preserved here as captured for implementation matching. Before relying on a report, check that success is true, that each data item has the expected platform, platformPostId, and accountId, that metrics fields are present for the posts you expect to be supported, and that pagination matches the page and limit you requested. If a post is missing metrics, if accountId does not match the connected Company Page integration ID, or if a date range exceeds 366 days, treat that as a failure check to resolve in the request rather than filling in values in the report.
| Parameter | Value in example | Purpose |
|---|---|---|
| source | platform | Retrieve existing platform posts, including Company Page posts not published through the API |
| platform | Select LinkedIn | |
| accountId | acc_li_org_456 | Integration ID for the connected LinkedIn Company Page |
| limit | 10 | Page size |
| page | 1 | Page number |
Exact captured parameter names and values; origin modularized as {{API_BASE_URL}}.
| Field | Type in example | Meaning |
|---|---|---|
| platform | string | Platform identifier, linkedin |
| platformPostId | string | Platform post identifier, for example urn:li:share:7469000000000000000 |
| accountId | string | Connected Company Page integration ID |
| metrics.impressions | number | Total impressions |
| metrics.reach | number | Unique reach |
| metrics.likes | number | Likes |
| metrics.comments | number | Comments |
| metrics.shares | number | Shares |
| metrics.clicks | number | Clicks through from the post |
| metrics.engagementRate | number | Engagement rate calculated from likes, comments, shares, and clicks relative to impressions |
| collectedAt | string | Collection timestamp |
| pagination.page | number | Current page |
| pagination.limit | number | Page size |
| pagination.total | number | Total items |
| pagination.totalPages | number | Total pages |
Field names preserved exactly as captured.
| Check | Expected result | Failure action |
|---|---|---|
| accountId is the connected Company Page integration ID | Data items match that Company Page | Re-check the integration ID; do not use a personal-profile identifier |
| source=platform with platform=linkedin | Existing supported Company Page posts are included | Correct source and platform values |
| Date range within 366 days using fromDate and toDate | Filtered results for the requested period | Shorten the range to no more than 366 days |
| engagementRate denominator | Likes, comments, shares, and clicks relative to impressions | Do not recalculate against reach or clicks |
| Pagination complete | page, limit, total, and totalPages are consistent | Fetch remaining pages before reporting totals |
Derived from captured scope and limits; no additional status codes invented.
Frequently asked questions
Which LinkedIn metrics can I retrieve?
Supported Company Page posts return impressions, unique reach, likes, comments, shares, clicks, and engagement rate.
Does LinkedIn Analytics work for personal-profile posts?
No. Analytics currently cover Company Page posts only, not personal profiles.
Can I retrieve Company Page posts that were not published through the API?
Yes. Set source=platform, platform=linkedin, and the connected Page's accountId to include older Page content that was not created through this API.
How do I retrieve analytics for a specific Company Page?
Pass the connected Page's integration ID as accountId in the request.
How far back can I filter LinkedIn analytics?
Pass fromDate and toDate for a window no longer than 366 days.
How is LinkedIn engagement rate calculated?
It combines likes, comments, shares, and clicks, then expresses that total relative to impressions.
Do I need to manage LinkedIn OAuth tokens myself?
No. The connected integration handles OAuth and token management, so callers do not maintain LinkedIn tokens directly.
Can I use LinkedIn analytics to track B2B Company Page content performance?
Yes. Impressions, unique reach, clicks, and engagement data can feed B2B dashboards and content-performance reporting for Company Pages.
{
"success": true,
"data": [
{
"platform": "linkedin",
"platformPostId": "urn:li:share:7469000000000000000",
"accountId": "acc_li_org_456",
"metrics": {
"impressions": 8420,
"reach": 6210,
"likes": 142,
"comments": 18,
"shares": 9,
"clicks": 311,
"engagementRate": 5.7
},
"collectedAt": "2026-08-31T12:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 1,
"totalPages": 1
}
}