Partager via

Organization Follower Statistics

  • Article

Warning

Deprecation Notice
The Marketing Version 202311 (Marketing November 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will 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.

The organizationalEntityFollowerStatistics API allows you to retrieve both lifetime and time-bound statistics on followers for an organization.

  • Lifetime follower statistics: To retrieve lifetime follower statistics, omit the timeIntervals query parameter. The API returns follower counts segmented by various facets such as geo location and industry.

  • Time-bound follower statistics: To retrieve time-bound follower statistics, include the timeIntervals query parameter. The API returns the aggregate follower count for both paid and organic followers during the days, weeks or months of the selected date range, based on the specified timeIntervals.timeGranularityType.

Note

Time-bound follower counts are aggregated and not segmented by facet.

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

Retrieve Lifetime Follower Statistics

Calling organizationalEntityFollowerStatistics without specifying a timeIntervals parameter will retrieve lifetime follower statistics segmented by various professional demographic facets. Professional Demographic results are rolled up as a total of both organic and paid followers in the organicFollowerCount field. Do not refer to the paidFollowerCount field for professional demographic statistics.

This endpoint no longer returns totalFollowerCounts. Use the networkSizes API under Organization Lookup to retrieve an organization's total follower count.

Professional Demographic Facets

Follower statistics can be broken down by 7 professional demographic facets. The results for any individual facet are limited to the top 100 results. For example, if a page has followers in more than 100 countries/regions, only the top 100 countries/regions will be returned.

Professional Demographic results are rolled up as a total of both organic and paid followers in the organicFollowerCount field. Do not refer to the paidFollowerCount field for professional demographic statistics.

Facet Description
followerCountsByAssociationType Counts by association type(employee) of the followers.
followerCountsByGeoCountry Counts by country/region of the followers. The array will contain one item per country/region.
followerCountsByFunction Counts by the function of the followers. The array will contain one item per function.
followerCountsByIndustry Counts by industry of the followers. The array will contain one item per industry.
followerCountsByGeo Counts by market area of the followers. The array will contain one item per market area.
followerCountsBySeniority Counts by the seniority of the followers. The array will contain one item per seniority
followerCountsByStaffCountRange Counts by staff count range of the current organizations of the followers. The array will contain one item per staff count range.
Facet Description
followerCountsByAssociationType Counts by association type(employee) of the followers.
followerCountsByCountry Counts by country/region of the followers. The array will contain one item per country/region.
followerCountsByFunction Counts by the function of the followers. The array will contain one item per function.
followerCountsByIndustry Counts by industry of the followers. The array will contain one item per industry.
followerCountsByRegion Counts by region of the followers. The array will contain one item per region.
followerCountsBySeniority Counts by the seniority of the followers. The array will contain one item per seniority
followerCountsByStaffCountRange Counts by staff count range of the current organizations of the followers. The array will contain one item per staff count range.

See Standardized Data for additional detail on these professional demographic facets.

Sample Request

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

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

Parameters

Field Description Format Required
organizationalEntity The organization identifier. URN Must be of format urn:li:organization:{id}. Yes
timeIntervals Time restriction for the query. When omitted, segmented lifetime stats are returned as shown in response below. object No
timeIntervals.timeGranularityType Granularity of the statistics. Must be DAY, WEEK 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 the longest allowed data retention time when set before that. long Yes
timeIntervals.timeRange.end Exclusive ending timestamp of when the query should end (milliseconds since epoch). Queries until current time when not set. long No

Sample Response

{
  "paging": {
    "count": 10,
    "start": 0
  },
  "elements": [
    {
       "followerCountsByStaffCountRange":[
          {
             "followerCounts":{
                "organicFollowerCount":29,
                "paidFollowerCount":0
             },
             "staffCountRange":"SIZE_1"
          },
          {
             "followerCounts":{
                "organicFollowerCount":6,
                "paidFollowerCount":0
             },
             "staffCountRange":"SIZE_2_TO_10"
          }
       ],
       "followerCountsByFunction":[
          {
             "followerCounts":{
                "organicFollowerCount":1662,
                "paidFollowerCount":0
             },
             "function":"urn:li:function:22"
          },
          {
             "followerCounts":{
                "organicFollowerCount":674,
                "paidFollowerCount":0
             },
             "function":"urn:li:function:13"
          },
          {
             "followerCounts":{
                "organicFollowerCount":62,
                "paidFollowerCount":0
             },
             "function":"urn:li:function:25"
          },
          {
             "followerCounts":{
                "organicFollowerCount":1,
                "paidFollowerCount":0
             },
             "function":"urn:li:function:15"
          }
       ],
       "followerCountsByAssociationType":[
          {
             "followerCounts":{
                "organicFollowerCount":196,
                "paidFollowerCount":0
             },
             "associationType":"EMPLOYEE"
          }
       ],
       "followerCountsBySeniority":[
          {
             "followerCounts":{
                "organicFollowerCount":4,
                "paidFollowerCount":0
             },
             "seniority":"urn:li:seniority:2"
          },
          {
             "followerCounts":{
                "organicFollowerCount":3,
                "paidFollowerCount":0
             },
             "seniority":"urn:li:seniority:3"
          },
          {
             "followerCounts":{
                "organicFollowerCount":2,
                "paidFollowerCount":0
             },
             "seniority":"urn:li:seniority:8"
          },
          {
             "followerCounts":{
                "organicFollowerCount":1,
                "paidFollowerCount":0
             },
             "seniority":"urn:li:seniority:9"
          }
       ],
       "followerCountsByGeoCountry":[
          {
             "geo":"urn:li:geo:102713980",
             "followerCounts":{
                "organicFollowerCount":66,
                "paidFollowerCount":0
             }
          },
          {
             "geo":"urn:li:geo:103644278",
             "followerCounts":{
                "organicFollowerCount":60,
                "paidFollowerCount":0
             }
          }
       ],
       "followerCountsByGeo":[
          {
             "geo":"urn:li:geo:90009626",
             "followerCounts":{
                "organicFollowerCount":84,
                "paidFollowerCount":0
             }
          },
          {
             "geo":"urn:li:geo:90009633",
             "followerCounts":{
                "organicFollowerCount":74,
                "paidFollowerCount":0
             }
          }
       ],
       "followerCountsByIndustry":[
          {
             "followerCounts":{
                "organicFollowerCount":33,
                "paidFollowerCount":0
             },
             "industry":"urn:li:industry:96"
          },
          {
             "followerCounts":{
                "organicFollowerCount":15,
                "paidFollowerCount":0
             },
             "industry":"urn:li:industry:4"
          },
          {
             "followerCounts":{
                "organicFollowerCount":12,
                "paidFollowerCount":0
             },
             "industry":"urn:li:industry:6"
          }
       ],
       "organizationalEntity":"urn:li:organization:1234"
    }
  ]
}

For details on various segments and URNs returned in the response, such as seniority and function, see Standardized Data.

Retrieve Time-Bound Follower Statistics

Specifying the timeIntervals parameter will retrieve time-bound follower statistics. This endpoint will provide statistics from 12 months before the request date (UTC) till 2 days before the request date (UTC). For example, if you are calling this endpoint on December 31, 2021, the first available data point will be December 31, 2020 and the last data point available will be December 29, 2021.

Sample Request

To fetch daily organization follower statistics for the first week of March 2019:

Restli 1.0:

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

Restli 2.0:

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

Restli 1.0:

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

Restli 2.0:

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

Sample Response

{
  "paging": {
    "count": 10,
    "start": 0
  },
  "elements": [
        {
            "timeRange": {
                "start": 1536364800000, 
                "end": 1536451200000
            }, 
            "followerGains": {
                "organicFollowerGain": 223, 
                "paidFollowerGain": 12
            }, 
            "organizationalEntity": "urn:li:organization:2414183"
        }, 
        {
            "timeRange": {
                "start": 1536451200000, 
                "end": 1536537600000
            }, 
            "followerGains": {
                "organicFollowerGain": 1, 
                "paidFollowerGain": 2
            }, 
            "organizationalEntity": "urn:li:organization:2414183"
        }, 
        {
            "timeRange": {
                "start": 1536537600000, 
                "end": 1536624000000
            }, 
            "followerGains": {
                "organicFollowerGain": 23, 
                "paidFollowerGain": 7
            }, 
            "organizationalEntity": "urn:li:organization:2414183"
        }, 
        {
            "timeRange": {
                "start": 1536624000000, 
                "end": 1536710400000
            }, 
            "followerGains": {
                "organicFollowerGain": 9, 
                "paidFollowerGain": 0
            }, 
            "organizationalEntity": "urn:li:organization:2414183"
        }, 
        {
            "timeRange": {
                "start": 1536710400000, 
                "end": 1536796800000
            }, 
            "followerGains": {
                "organicFollowerGain": 2, 
                "paidFollowerGain": 3
            }, 
            "organizationalEntity": "urn:li:organization:2414183"
        }
    ]
}