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
timeIntervalsquery parameter. The API returns view and click statistics segmented by various facets.Time-bound page statistics: To retrieve time-bound page statistics, include the
timeIntervalsquery parameter. The API returns aggregate page statistics within all of the days or months in between the selected date range based on the specifiedtimeIntervals.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:
|
Retrieve Lifetime Organization Page Statistics
Not specifying a timeIntervals parameter will retrieve lifetime page statistics.
Sample Request
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:
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:
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
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:
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:
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": []
}
}