Skip to content

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.

LinkedIn Analytics API request for Company Page posts
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"
Illustrative request
Example line 1

curl -X GET "{{API_BASE_URL}}/v1/analytics?source=platform&platform=linkedin&accountId=acc_li_org_456&limit…

Illustrative request
Example line 2

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

LinkedIn Analytics API request parameters
ParameterValue in examplePurpose
sourceplatformRetrieve existing platform posts, including Company Page posts not published through the API
platformlinkedinSelect LinkedIn
accountIdacc_li_org_456Integration ID for the connected LinkedIn Company Page
limit10Page size
page1Page number

Exact captured parameter names and values; origin modularized as {{API_BASE_URL}}.

LinkedIn Analytics API response field map
FieldType in exampleMeaning
platformstringPlatform identifier, linkedin
platformPostIdstringPlatform post identifier, for example urn:li:share:7469000000000000000
accountIdstringConnected Company Page integration ID
metrics.impressionsnumberTotal impressions
metrics.reachnumberUnique reach
metrics.likesnumberLikes
metrics.commentsnumberComments
metrics.sharesnumberShares
metrics.clicksnumberClicks through from the post
metrics.engagementRatenumberEngagement rate calculated from likes, comments, shares, and clicks relative to impressions
collectedAtstringCollection timestamp
pagination.pagenumberCurrent page
pagination.limitnumberPage size
pagination.totalnumberTotal items
pagination.totalPagesnumberTotal pages

Field names preserved exactly as captured.

LinkedIn Analytics API failure and edge checks
CheckExpected resultFailure action
accountId is the connected Company Page integration IDData items match that Company PageRe-check the integration ID; do not use a personal-profile identifier
source=platform with platform=linkedinExisting supported Company Page posts are includedCorrect source and platform values
Date range within 366 days using fromDate and toDateFiltered results for the requested periodShorten the range to no more than 366 days
engagementRate denominatorLikes, comments, shares, and clicks relative to impressionsDo not recalculate against reach or clicks
Pagination completepage, limit, total, and totalPages are consistentFetch 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.

LinkedIn Analytics API response with metrics and pagination
{
    "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
    }
}