Organization Follower Statistics

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 region 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 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 demographic facets. 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 demographic statistics.

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

Demographic Facets

Follower statistics can be broken down by 7 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, only the top 100 countries will be returned.

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

Facet Description
followerCountsByAssociationType Counts by association type(paid or organic) of the followers.
followerCountsByCountry Counts by country of the followers. The array will contain one item per country.
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 demographic facets.

Sample Request

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} or urn:li:organizationBrand:{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 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

Sample Response

{
  "paging": {
    "count": 10,
    "start": 0
  },
  "elements": [
    {
      "followerCountsByStaffCountRange": [
        {
          "followerCounts": {
            "organicFollowerCount": 6,
            "paidFollowerCount": 0
          },
          "staffCountRange": "SIZE_1"
        },
        {
          "followerCounts": {
            "organicFollowerCount": 29,
            "paidFollowerCount": 0
          },
          "staffCountRange": "SIZE_2_TO_10"
        },
      ],
      "followerCountsByFunction": [
        {
          "followerCounts": {
            "organicFollowerCount": 1662,
            "paidFollowerCount": 0
          },
          "function": "urn:li:function:22"
        },
        {
          "followerCounts": {
            "organicFollowerCount": 21,
            "paidFollowerCount": 0
          },
          "function": "urn:li:function:11"
        },
        {
          "followerCounts": {
            "organicFollowerCount": 3,
            "paidFollowerCount": 0
          },
          "function": "urn:li:function:12"
        },
        {
          "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"
        },
        {
          "followerCounts": {
            "organicFollowerCount": 5,
            "paidFollowerCount": 0
          },
          "function": "urn:li:function:16"
        },
        {
          "followerCounts": {
            "organicFollowerCount": 1,
            "paidFollowerCount": 0
          },
          "function": "urn:li:function:17"
        },
        {
          "followerCounts": {
            "organicFollowerCount": 1237,
            "paidFollowerCount": 0
          },
          "function": "urn:li:function:8"
        },
        {
          "followerCounts": {
            "organicFollowerCount": 22,
            "paidFollowerCount": 0
          },
          "function": "urn:li:function:10"
        }
      ],
      "followerCountsByAssociationType": [
        {
          "followerCounts": {
            "organicFollowerCount": 1228,
            "paidFollowerCount": 0
          }
        }
      ],
      "followerCountsBySeniority": [
        {
          "followerCounts": {
            "organicFollowerCount": 1,
            "paidFollowerCount": 0
          },
          "seniority": "urn:li:seniority:2"
        },
        {
          "followerCounts": {
            "organicFollowerCount": 2484,
            "paidFollowerCount": 0
          },
          "seniority": "urn:li:seniority:3"
        },
        {
          "followerCounts": {
            "organicFollowerCount": 3,
            "paidFollowerCount": 0
          },
          "seniority": "urn:li:seniority:8"
        },
        {
          "followerCounts": {
            "organicFollowerCount": 1,
            "paidFollowerCount": 0
          },
          "seniority": "urn:li:seniority:9"
        }
      ],
      "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), or later. For example, if you are calling this endpoint on December 31, 2018, the first available data point will be December 31, 2017 and the last data point available will be December 29, 2018 or later.

Sample Request

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

Restli 1.0:

GET https://api.linkedin.com/v2/organizationalEntityFollowerStatistics?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/organizationalEntityFollowerStatistics?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": 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"
        }
    ]
}