Organization Share Statistics

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.

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/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/v2/organizationalEntityShareStatistics?q=organizationalEntity&organizationalEntity=urn:li:organization:2414183&timeIntervals.timeGranularityType=DAY&timeIntervals.timeRange.start=1551398400000&timeIntervals.timeRange.end=1552003200000

Restli 2.0:

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