Organization Share Statistics

  • Article

Warning

Deprecation Notice
The Marketing version 202304 (Marketing April 2023) and below has been sunset and the unversioned APIs are going to be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

This endpoint returns organic statistics only. Sponsored activity is not counted in this endpoint. Use Ad Analytics to retrieve statistics for sponsored activity.

  • Lifetime share statistics: To retrieve lifetime share statistics, omit the timeIntervals query parameter. The API returns aggregated stats for an organization's shares.

  • Time-bound share statistics: To retrieve time-bound share statistics, include the timeIntervals query parameter. The API returns aggregate share stats within all of the days or months in between the selected date range based on the specified timeIntervals.timeGranularityType.

The organizationalEntityShareStatistics endpoint returns share data only within the past 12 months, using a rolling 12-month window.

Permissions

Permission Description
rw_organization_admin Manage organizations pages and retrieve reporting data. Restricted to organizations in which the authenticated member has the following role:
  • ADMINISTRATOR

Schema

Field Name Type Description
organizationalEntity Organization URN The organizational entity URN for which the statistics represents.
share Share URN The share URN for describing individual share statistics. Is blank for aggregate share statistics.
ugcPost UGC Post The UGC Post URN for describing individual share statistics.
timeRange.start Timestamp (milliseconds since epoch) Exclusive starting timestamp of when the query should begin.
totalShareStatistics ShareStatisticsData Share statistics representing the total counts.

Share Statistics Data Schema

Field Name Type Description
clickCount long Number of clicks.
commentCount long Number of comments.
commentMentionsCount optional long Number of mentions of the organizational entity in a comment across LinkedIn. The field does not have a value when individual share statistics are requested.
engagement double Number of organic clicks, likes, comments, and shares over impressions.
impressionCount long Number of impressions.
likeCount long Number of likes. This field can become negative when members who liked a sponsored share later unlike it. The like is not counted since it is not organic, but the unlike is counted as organic.
shareCount long Number of shares.
shareMentionsCount optional long Number of mentions of the organizational entity in a share across LinkedIn. The field does not have a value when individual share statistics are requested.
uniqueImpressionsCount long Number of unique impressions.

Retrieve Lifetime Share Statistics

Not specifying a timeIntervals parameter will retrieve lifetime share statistics.

Sample Request

GET https://api.linkedin.com/rest/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity={organization URN}

Sample Request Example

https://api.linkedin.com/rest/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn%3Ali%3Aorganization%3A2414183

Note

The /organizationalEntityShareStatistics endpoint does not support pagination.

GET https://api.linkedin.com/v2/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity={organization URN}

Parameters

Field Description Format Required
organizationalEntity The organization identifier URN Must be of format urn:li:organization:{id} or urn:li:organizationBrand:{id} Yes
timeIntervals Time restriction for the query. When omitted, lifetime stats are returned as shown in response below. object No
timeIntervals.timeGranularityType Granularity of the statistics. Must be either DAY or MONTH string No
timeIntervals.timeRange The time range object Yes
timeIntervals.timeRange.start Exclusive starting timestamp of when the query should begin (milliseconds since epoch) Queries from beginning of time when not set. long No
timeIntervals.timeRange.end Inclusive ending timestamp of when the query should end (milliseconds since epoch). Queries until current time when not set. long No
shares References to one or more shares for which statistics are returned share URN. Multiple allowed No
ugcPosts References to one or more UGC Posts for which statistics are returned ugcPost URN. Multiple allowed No

Sample Response

{
  "paging": {
    "count": 10,
    "start": 0
  },
  "elements": [
    {
      "totalShareStatistics": {
        "uniqueImpressionsCount": 9327,
        "clickCount": 109276,
        "engagement": 0.007549471334119487,
        "likeCount": 52,
        "commentCount": 70,
        "shareCount": 0,
        "commentMentionsCount": 0,
        "impressionCount": 14490816,
        "shareMentionsCount": 2
      },
      "organizationalEntity": "urn:li:organization:2414183"
    }
  ]
}

In some cases, the likeCount and commentCount field values might not match counts listed alongside the share on the LinkedIn feed. These fields may not match because:

  • The likeCount and commentCount fields do not count likes or comments made by companies, including the company that authored the share.
  • The likeCount and commentCount fields are not decremented when a like or comment is deleted.
  • The counts returned are eventually consistent, not immediately consistent, and can take up to 24-48 hours in some cases.

The socialActions endpoint provides up-to-date counts of likes and comments for a share that matches the LinkedIn feed.

Retrieve Time-Bound Share Statistics

Specifying the timeIntervals parameter will retrieve time-bound share statistics.

Sample Request

Fetch daily organization share statistics for the first week of March 2019:

Restli 1.0:

GET https://api.linkedin.com/rest/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn:li:organization:2414183&timeIntervals.timeGranularityType=DAY&timeIntervals.timeRange.start=1551398400000&timeIntervals.timeRange.end=1552003200000

Restli 2.0:

GET https://api.linkedin.com/rest/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn%3Ali%3Aorganization%3A2414183&timeIntervals=(timeRange:(start:1551398400000,end:1552003200000),timeGranularityType:DAY)'

Sample Request Example

GET 'https://api.linkedin.com/rest/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn%3Ali%3Aorganization%3A79988552&timeIntervals=(timeRange%3A(start%3A1551398400000%2Cend%3A1552003200000)%2CtimeGranularityType%3ADAY)'

Restli 1.0:

GET https://api.linkedin.com/v2/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn:li:organization:2414183&timeIntervals.timeGranularityType=DAY&timeIntervals.timeRange.start=1551398400000&timeIntervals.timeRange.end=1552003200000

Restli 2.0:

GET https://api.linkedin.com/v2/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn%3Ali%3Aorganization%3A2414183&timeIntervals=(timeRange:(start:1551398400000,end:1552003200000),timeGranularityType:DAY)

Sample Response

{
  "paging": {
    "count": 10,
    "start": 0
  },
  "elements": [
    {
      "timeRange": {
        "start": 1451606400000,
        "end": 1451692800000
      },
      "totalShareStatistics": {
        "clickCount": 0,
        "engagement": 0,
        "likeCount": 0,
        "commentCount": 0,
        "shareCount": 0,
        "impressionCount": 331,
        "uniqueImpressionsCounts": 203
      },
      "organizationalEntity": "urn:li:organization:2414183"
    },
    {
      "timeRange": {
        "start": 1451692800000,
        "end": 1451779200000
      },
      "totalShareStatistics": {
        "clickCount": 0,
        "engagement": 0,
        "likeCount": 0,
        "commentCount": 0,
        "shareCount": 0,
        "impressionCount": 0
      },
      "organizationalEntity": "urn:li:organization:2414183"
    },
    {
      "timeRange": {
        "start": 1451779200000,
        "end": 1451865600000
      },
      "totalShareStatistics": {
        "clickCount": 0,
        "engagement": 0,
        "likeCount": 0,
        "commentCount": 0,
        "shareCount": 0,
        "impressionCount": 0
      },
      "organizationalEntity": "urn:li:organization:2414183"
    },
    {
      "timeRange": {
        "start": 1451865600000,
        "end": 1451952000000
      },
      "totalShareStatistics": {
        "clickCount": 0,
        "engagement": 0,
        "likeCount": 0,
        "commentCount": 0,
        "shareCount": 0,
        "impressionCount": 0
      },
      "organizationalEntity": "urn:li:organization:2414183"
    },
    {
      "timeRange": {
        "start": 1451952000000,
        "end": 1452038400000
      },
      "totalShareStatistics": {
        "clickCount": 0,
        "engagement": 0,
        "likeCount": 0,
        "commentCount": 0,
        "shareCount": 0,
        "impressionCount": 0
      },
      "organizationalEntity": "urn:li:organization:2414183"
    },
    {
      "timeRange": {
        "start": 1452038400000,
        "end": 1452124800000
      },
      "totalShareStatistics": {
        "clickCount": 0,
        "engagement": 0,
        "likeCount": 0,
        "commentCount": 0,
        "shareCount": 0,
        "impressionCount": 0
      },
      "organizationalEntity": "urn:li:organization:2414183"
    },
    {
      "timeRange": {
        "start": 1452124800000,
        "end": 1452211200000
      },
      "totalShareStatistics": {
        "clickCount": 0,
        "engagement": 0,
        "likeCount": 0,
        "commentCount": 0,
        "shareCount": 0,
        "impressionCount": 0
      },
      "organizationalEntity": "urn:li:organization:2414183"
    }
  ]
}

Retrieve Statistics for Specific Shares

Note

A share URN is required for this API. Either post a new organization share or retrieve an existing organization share to get one.

Sample Request

Fetch lifetime share statistics for two specific organization shares:

GET 'https://api.linkedin.com/rest/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn%3Ali%3Aorganization%3A2414183&shares=List(urn%3Ali%3Ashare%3A7132564752928563200,urn%3Ali%3Ashare%3A7132402731377438720)

GET https://api.linkedin.com/v2/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn:li:organization:2414183&shares[0]=urn:li:share:1000000&shares[1]=urn:li:share:1000001

Sample Response

{
    "elements": [
        {
            "organizationalEntity": "urn:li:organization:2414183",
            "share": "urn:li:share:1000000",
            "totalShareStatistics": {
                "clickCount": 78,
                "commentCount": 24,
                "engagement": 0.022886324947985624,
                "impressionCount": 5287,
                "likeCount": 14,
                "shareCount": 5
            }
        },
        {
            "organizationalEntity": "urn:li:organization:2414183",
            "share": "urn:li:share:1000001",
            "totalShareStatistics": {
                "clickCount": 1,
                "commentCount": 0,
                "engagement": 0.2,
                "impressionCount": 5,
                "likeCount": 0,
                "shareCount": 0
            }
        }
    ],
    "paging": {
        "count": 10,
        "links": [],
        "start": 0
    }
}

Elements with share fields indicate each requested share.

Shares with no actions or impressions are not included in the list of elements. Shares that are not returned in the list of elements can be assumed to have counts of 0 for all statistics.

Retrieve Statistics for Specific UGC Posts

A UGC URN is required for this API. Either post a new organization UGC Post or retrieve an existing UGC Post to get one.

Sample Request

Fetch lifetime share statistics for two specific organization UGC Posts:

GET https://api.linkedin.com/rest/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn:li:organization:2414183&ugcPosts[0]=urn:li:ugcPost:1000000&ugcPosts[1]=urn:li:ugcPost:1000001

GET https://api.linkedin.com/v2/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn:li:organization:2414183&ugcPosts[0]=urn:li:ugcPost:1000000&ugcPosts[1]=urn:li:ugcPost:1000001

Sample Response

{
    "elements": [
        {
            "organizationalEntity": "urn:li:organization:2414183",
            "ugcPost": "urn:li:ugcPost:1000000",
            "totalShareStatistics": {
                "clickCount": 78,
                "commentCount": 24,
                "engagement": 0.022886324947985624,
                "impressionCount": 5287,
                "likeCount": 14,
                "shareCount": 5
            }
        },
        {
            "organizationalEntity": "urn:li:organization:2414183",
            "ugcPost": "urn:li:ugcPost:1000001",
            "totalShareStatistics": {
                "clickCount": 1,
                "commentCount": 0,
                "engagement": 0.2,
                "impressionCount": 5,
                "likeCount": 0,
                "shareCount": 0
            }
        }
    ],
    "paging": {
        "count": 10,
        "links": [],
        "start": 0
    }
}

Elements with ugcPost fields indicate each requested UGC Post.

UGC Posts with no actions or impressions are not included in the list of elements. UGC Posts that are not returned in the list of elements can be assumed to have counts of 0 for all statistics.