Organization Page Statistics
Warning
Deprecation Notice
The Marketing version 202304 (Marketing April 2023) and below has been sunset and the unversioned APIs are going to 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.
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.
Note
The pageStatisticsByGeo and pageStatisticsByGeoCountry fields in the 202402 version are still undergoing development and may not work as expected. It is advised to use the pageStatisticsByRegion and pageStatisticsByCountry fields from previous versions instead of upgrading for now.
- 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
}
}
Sample Response
{
"elements": [
{
"organization": "urn:li:organization:2414183",
"pageStatisticsByGeoCountry": [
{
"geo": "urn:li:geo:103644278",
"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
}
}
}
}
],
"pageStatisticsByIndustryV2": [
{
"industryV2": "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
}
}
}
}
],
"pageStatisticsByGeo": [
{
"geo": "urn:li:geo:7",
"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
}
}
}
}
],
"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": {
"desktopCustomButtonClickCounts": [],
"mobileCustomButtonClickCounts": []
},
"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. |
Sample Response
{
"paging": {
"count": 10,
"start": 0
},
"elements": [
{
"organization": "urn:li:organization:2414183",
"timeRange": {
"start": 1451606400000,
"end": 1451692800000
},
"totalPageStatistics": {
"clicks": {
"desktopCustomButtonClickCounts": [],
"mobileCustomButtonClickCounts": []
},
"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": {
"desktopCustomButtonClickCounts": [],
"mobileCustomButtonClickCounts": []
},
"views": {
"careersPageViews": {
"uniquePageViews": 0,
"pageViews": 0
},
"overviewPageViews": {
"uniquePageViews": 0,
"pageViews": 0
},
"allPageViews": {
"uniquePageViews": 0,
"pageViews": 0
}
}
}
}
]
}
Career Page Statistics
Note
totalPageStatistics includes careersPageViews, and is only available for organizations that have career pages. This is a paid product. For more information, see Company Career Pages.
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": []
}
}
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for