Organization Page Statistics

organizationPageStatistics and brandPageStatistics allow you to retrieve both lifetime and time-bound statistics on views and clicks for an organization or organization brand page respectively.

  • Lifetime page statistics: To retrieve lifetime page statistics, omit the timeIntervals query parameter. The API returns view and click statistics segmented by various facets.

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

Note

LinkedIn provides a detailed breakdown of Mobile, Desktop, and Overall page views. The reported counts for allPageViews and overviewPageViews are higher because they include comprehensive mobile and desktop traffic.

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 Organization Page Statistics

Not specifying a timeIntervals parameter will retrieve lifetime page statistics.

Sample Request

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

Parameters

Field Description Format Required
organization The organization identifier. URN. Must be of format urn:li:organization:{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

Sample Response

{
    "elements": [
        {
            "organization": "urn:li:organization:2414183",
            "pageStatisticsByCountry": [
                {
                    "country": "urn:li:country:us",
                    "pageStatistics": {
                        "views": {
                            "allDesktopPageViews": {
                                "pageViews": 1680
                            },
                            "allMobilePageViews": {
                                "pageViews": 16
                            },
                            "allPageViews": {
                                "pageViews": 1696
                            },
                            "careersPageViews": {
                                "pageViews": 3
                            },
                            "desktopCareersPageViews": {
                                "pageViews": 3
                            },
                            "desktopJobsPageViews": {
                                "pageViews": 0
                            },
                            "desktopLifeAtPageViews": {
                                "pageViews": 3
                            },
                            "desktopOverviewPageViews": {
                                "pageViews": 1677
                            },
                            "jobsPageViews": {
                                "pageViews": 0
                            },
                            "lifeAtPageViews": {
                                "pageViews": 3
                            },
                            "mobileCareersPageViews": {
                                "pageViews": 0
                            },
                            "mobileJobsPageViews": {
                                "pageViews": 0
                            },
                            "mobileLifeAtPageViews": {
                                "pageViews": 0
                            },
                            "mobileOverviewPageViews": {
                                "pageViews": 16
                            },
                            "overviewPageViews": {
                                "pageViews": 1693
                            }
                        }
                    }
                }
            ],
            "pageStatisticsByFunction": [
                {
                    "function": "urn:li:function:1",
                    "pageStatistics": {
                        "views": {
                            "allDesktopPageViews": {
                                "pageViews": 25
                            },
                            "allMobilePageViews": {
                                "pageViews": 0
                            },
                            "allPageViews": {
                                "pageViews": 25
                            },
                            "careersPageViews": {
                                "pageViews": 0
                            },
                            "desktopCareersPageViews": {
                                "pageViews": 0
                            },
                            "desktopJobsPageViews": {
                                "pageViews": 0
                            },
                            "desktopLifeAtPageViews": {
                                "pageViews": 0
                            },
                            "desktopOverviewPageViews": {
                                "pageViews": 25
                            },
                            "jobsPageViews": {
                                "pageViews": 0
                            },
                            "lifeAtPageViews": {
                                "pageViews": 0
                            },
                            "mobileCareersPageViews": {
                                "pageViews": 0
                            },
                            "mobileJobsPageViews": {
                                "pageViews": 0
                            },
                            "mobileLifeAtPageViews": {
                                "pageViews": 0
                            },
                            "mobileOverviewPageViews": {
                                "pageViews": 0
                            },
                            "overviewPageViews": {
                                "pageViews": 25
                            }
                        }
                    }
                }
            ],
            "pageStatisticsByIndustry": [
                {
                    "industry": "urn:li:industry:1",
                    "pageStatistics": {
                        "views": {
                            "allDesktopPageViews": {
                                "pageViews": 33
                            },
                            "allMobilePageViews": {
                                "pageViews": 0
                            },
                            "allPageViews": {
                                "pageViews": 33
                            },
                            "careersPageViews": {
                                "pageViews": 0
                            },
                            "desktopCareersPageViews": {
                                "pageViews": 0
                            },
                            "desktopJobsPageViews": {
                                "pageViews": 0
                            },
                            "desktopLifeAtPageViews": {
                                "pageViews": 0
                            },
                            "desktopOverviewPageViews": {
                                "pageViews": 33
                            },
                            "jobsPageViews": {
                                "pageViews": 0
                            },
                            "lifeAtPageViews": {
                                "pageViews": 0
                            },
                            "mobileCareersPageViews": {
                                "pageViews": 0
                            },
                            "mobileJobsPageViews": {
                                "pageViews": 0
                            },
                            "mobileLifeAtPageViews": {
                                "pageViews": 0
                            },
                            "mobileOverviewPageViews": {
                                "pageViews": 0
                            },
                            "overviewPageViews": {
                                "pageViews": 33
                            }
                        }
                    }
                }
            ],
            "pageStatisticsByRegion": [
                {
                    "pageStatistics": {
                        "views": {
                            "allDesktopPageViews": {
                                "pageViews": 62
                            },
                            "allMobilePageViews": {
                                "pageViews": 1
                            },
                            "allPageViews": {
                                "pageViews": 63
                            },
                            "careersPageViews": {
                                "pageViews": 0
                            },
                            "desktopCareersPageViews": {
                                "pageViews": 0
                            },
                            "desktopJobsPageViews": {
                                "pageViews": 0
                            },
                            "desktopLifeAtPageViews": {
                                "pageViews": 0
                            },
                            "desktopOverviewPageViews": {
                                "pageViews": 62
                            },
                            "jobsPageViews": {
                                "pageViews": 0
                            },
                            "lifeAtPageViews": {
                                "pageViews": 0
                            },
                            "mobileCareersPageViews": {
                                "pageViews": 0
                            },
                            "mobileJobsPageViews": {
                                "pageViews": 0
                            },
                            "mobileLifeAtPageViews": {
                                "pageViews": 0
                            },
                            "mobileOverviewPageViews": {
                                "pageViews": 1
                            },
                            "overviewPageViews": {
                                "pageViews": 63
                            }
                        }
                    },
                    "region": "urn:li:region:7"
                }
            ],
            "pageStatisticsBySeniority": [
                {
                    "pageStatistics": {
                        "views": {
                            "allDesktopPageViews": {
                                "pageViews": 320
                            },
                            "allMobilePageViews": {
                                "pageViews": 2
                            },
                            "allPageViews": {
                                "pageViews": 322
                            },
                            "careersPageViews": {
                                "pageViews": 1
                            },
                            "desktopCareersPageViews": {
                                "pageViews": 1
                            },
                            "desktopJobsPageViews": {
                                "pageViews": 0
                            },
                            "desktopLifeAtPageViews": {
                                "pageViews": 1
                            },
                            "desktopOverviewPageViews": {
                                "pageViews": 319
                            },
                            "jobsPageViews": {
                                "pageViews": 0
                            },
                            "lifeAtPageViews": {
                                "pageViews": 1
                            },
                            "mobileCareersPageViews": {
                                "pageViews": 0
                            },
                            "mobileJobsPageViews": {
                                "pageViews": 0
                            },
                            "mobileLifeAtPageViews": {
                                "pageViews": 0
                            },
                            "mobileOverviewPageViews": {
                                "pageViews": 2
                            },
                            "overviewPageViews": {
                                "pageViews": 321
                            }
                        }
                    },
                    "seniority": "urn:li:seniority:10"
                }
            ],
            "pageStatisticsByStaffCountRange": [
                {
                    "pageStatistics": {
                        "views": {
                            "allDesktopPageViews": {
                                "pageViews": 602
                            },
                            "allMobilePageViews": {
                                "pageViews": 12
                            },
                            "allPageViews": {
                                "pageViews": 614
                            },
                            "careersPageViews": {
                                "pageViews": 0
                            },
                            "desktopCareersPageViews": {
                                "pageViews": 0
                            },
                            "desktopJobsPageViews": {
                                "pageViews": 0
                            },
                            "desktopLifeAtPageViews": {
                                "pageViews": 0
                            },
                            "desktopOverviewPageViews": {
                                "pageViews": 602
                            },
                            "jobsPageViews": {
                                "pageViews": 0
                            },
                            "lifeAtPageViews": {
                                "pageViews": 0
                            },
                            "mobileCareersPageViews": {
                                "pageViews": 0
                            },
                            "mobileJobsPageViews": {
                                "pageViews": 0
                            },
                            "mobileLifeAtPageViews": {
                                "pageViews": 0
                            },
                            "mobileOverviewPageViews": {
                                "pageViews": 12
                            },
                            "overviewPageViews": {
                                "pageViews": 614
                            }
                        }
                    },
                    "staffCountRange": "SIZE_10001_OR_MORE"
                }
            ],
            "totalPageStatistics": {
                "clicks": {
                    "careersPageClicks": {
                        "careersPageBannerPromoClicks": 0,
                        "careersPageEmployeesClicks": 0,
                        "careersPageJobsClicks": 0,
                        "careersPagePromoLinksClicks": 0
                    },
                    "mobileCareersPageClicks": {
                        "careersPageEmployeesClicks": 0,
                        "careersPageJobsClicks": 0,
                        "careersPagePromoLinksClicks": 0
                    }
                },
                "views": {
                    "allDesktopPageViews": {
                        "pageViews": 17321
                    },
                    "allMobilePageViews": {
                        "pageViews": 465
                    },
                    "allPageViews": {
                        "pageViews": 17786
                    },
                    "careersPageViews": {
                        "pageViews": 5
                    },
                    "desktopCareersPageViews": {
                        "pageViews": 5
                    },
                    "desktopJobsPageViews": {
                        "pageViews": 0
                    },
                    "desktopLifeAtPageViews": {
                        "pageViews": 5
                    },
                    "desktopOverviewPageViews": {
                        "pageViews": 17316
                    },
                    "jobsPageViews": {
                        "pageViews": 0
                    },
                    "lifeAtPageViews": {
                        "pageViews": 5
                    },
                    "mobileCareersPageViews": {
                        "pageViews": 0
                    },
                    "mobileJobsPageViews": {
                        "pageViews": 0
                    },
                    "mobileLifeAtPageViews": {
                        "pageViews": 0
                    },
                    "mobileOverviewPageViews": {
                        "pageViews": 465
                    },
                    "overviewPageViews": {
                        "pageViews": 17781
                    }
                }
            }
        }
    ],
    "paging": {
        "count": 10,
        "links": [],
        "start": 0
    }
}

Retrieve Time-Bound Organization Page Statistics

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

Sample Request

Restli 1.0:

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

Restli 2.0:

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

Restli 1.0:

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

Restli 2.0:

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

Sample Response

{
  "paging": {
    "count": 10,
    "start": 0
  },
  "elements": [
    {
      "organization": "urn:li:organization:2414183",
      "timeRange": {
        "start": 1451606400000,
        "end": 1451692800000
      },
      "totalPageStatistics": {
        "clicks": {
          "careersPageClicks": {
            "careersPageBannerPromoClicks": 0,
            "careersPagePromoLinksClicks": 0,
            "careersPageEmployeesClicks": 0,
            "careersPageJobsClicks": 0
          }
        },
        "views": {
          "careersPageViews": {
            "uniquePageViews": 0,
            "pageViews": 0
          },
          "overviewPageViews": {
            "uniquePageViews": 0,
            "pageViews": 0
          },
          "allPageViews": {
            "pageViews": 0
          }
        }
      }
    },
    {
      "organization": "urn:li:organization:2414183",
      "timeRange": {
        "start": 1452124800000,
        "end": 1452211200000
      },
      "totalPageStatistics": {
        "clicks": {
          "careersPageClicks": {
            "careersPageBannerPromoClicks": 0,
            "careersPagePromoLinksClicks": 0,
            "careersPageEmployeesClicks": 0,
            "careersPageJobsClicks": 0
          }
        },
        "views": {
          "careersPageViews": {
            "uniquePageViews": 0,
            "pageViews": 0
          },
          "overviewPageViews": {
            "uniquePageViews": 0,
            "pageViews": 0
          },
          "allPageViews": {
            "uniquePageViews": 0,
            "pageViews": 0
          }
        }
      }
    }
  ]
}

Career Page Statistics

Note

totalPageStatistics includes careersPageViews and careersPageClicks, and is only available for organizations that have career pages. This is a paid product. For more information, see Company Career Pages.

Click terms for organizations with career pages:

Click Terms Definition
careersPageBannerPromoClicks Number of clicks on the banner promo on the careers page.
careersPageEmployeesClicks Number of clicks on the employees section on the careers page.
careersPageJobsClicks Number of clicks on the jobs section on the careers page.
careersPagePromoLinksClicks Number of clicks on the promo links on the careers page.

Retrieve Organization Brand Page Statistics

Sample Request

GET https://api.linkedin.com/rest/brandPageStatistics?q=brand&brand=urn:li:organizationBrand:3617422
GET https://api.linkedin.com/v2/brandPageStatistics?q=brand&brand=urn:li:organizationBrand:3617422

Parameters

Field Description Format Required
brand The organization brand identifier URN. Must be of format 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

Sample Response

{
    "elements": [
        {
            "brand": "urn:li:organizationBrand:18085185",
            "pageStatisticsByCountry": [],
            "pageStatisticsByFunction": [],
            "pageStatisticsByIndustry": [],
            "pageStatisticsByRegion": [],
            "pageStatisticsBySeniority": [],
            "pageStatisticsByStaffCountRange": [],
            "totalPageStatistics": {
                "views": {
                    "allDesktopPageViews": {
                        "pageViews": 1
                    },
                    "allMobilePageViews": {
                        "pageViews": 0
                    },
                    "allPageViews": {
                        "pageViews": 1
                    },
                    "desktopOverviewPageViews": {
                        "pageViews": 1
                    },
                    "mobileOverviewPageViews": {
                        "pageViews": 0
                    },
                    "overviewPageViews": {
                        "pageViews": 1
                    }
                }
            }
        }
    ],
    "paging": {
        "count": 10,
        "links": [],
        "start": 0
    }
}

Retrieve Organization Brand Time-Bound Page Statistics

Sample Request

Restli 1.0:

GET https://api.linkedin.com/rest/brandPageStatistics?q=brand&brand=urn:li:organizationBrand:11280505&timeIntervals.timeGranularityType=DAY&timeIntervals.timeRange.start=1551398400000&timeIntervals.timeRange.end=1552003200000

Restli 2.0:

GET https://api.linkedin.com/rest/brandPageStatistics?q=brand&brand=urn%3Ali%3AorganizationBrand%3A11280505&timeIntervals=(timeRange:(start:1551398400000,end:1552003200000),timeGranularityType:DAY)

Restli 1.0:

GET https://api.linkedin.com/v2/brandPageStatistics?q=brand&brand=urn:li:organizationBrand:11280505&timeIntervals.timeGranularityType=DAY&timeIntervals.timeRange.start=1551398400000&timeIntervals.timeRange.end=1552003200000

Restli 2.0:

GET https://api.linkedin.com/v2/brandPageStatistics?q=brand&brand=urn%3Ali%3AorganizationBrand%3A11280505&timeIntervals=(timeRange:(start:1551398400000,end:1552003200000),timeGranularityType:DAY)

Sample Response

{
    "elements": [
        {
            "brand": "urn:li:organizationBrand:11280505",
            "timeRange": {
                "start": 1537142400000,
                "end": 1537228800000
            }
        },
        {
            "brand": "urn:li:organizationBrand:11280505",
            "timeRange": {
                "start": 1537228800000,
                "end": 1537315200000
            }
        }
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "links": []
    }
}