Share via

Organization Share Statistics

Warning

Deprecation Notice The Marketing Version 202411 (Marketing November 2024) has been sunset. We recommend that you migrate to the latest versioned 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 statistics 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 statistics 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) Inclusive starting timestamp of when the query should begin. The smallest supported time granularity is on DAY level. For example, Nov 04 2025 23:59:59 is normalized to Nov 04 2025.
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.
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's not organic, but the unlike is counted as organic.
shareCount long Number of shares.
uniqueImpressionsCount long Number of unique impressions.

Retrieve Lifetime Share Statistics

Don't specify a timeIntervals parameter to 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 doesn't support pagination.

Parameters

Field Description Format Required
organizationalEntity The organization identifier. URN Must be of the 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 Inclusive starting timestamp of when the query should begin (milliseconds since epoch) Queries from beginning of time when not set. The smallest supported time granularity is on DAY level. For example, Nov 04 2025 23:59:59 is normalized to Nov 04 2025. long No
timeIntervals.timeRange.end Exclusive ending timestamp of when the query should end (milliseconds since epoch). Queries until current time when not set. The smallest supported time granularity is on DAY level. For example, Nov 04 2025 23:59:59 is normalized to Nov 04 2025. 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,
        "impressionCount": 14490816
      },
      "organizationalEntity": "urn:li:organization:2414183"
    }
  ]
}

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

Specify the timeIntervals parameter to 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)'

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"
    }
  ]
}

Note

The shareCount for the time-bound statistics won't match the lifetime statistics because the time-bound data won't include the count from instant reposts.

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. Time-bound statistics is not supported for specific share queries.

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)

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.

Time-bound statistics is not supported for specific UGC Post queries.

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

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.

  • Last updated on