Organization Page Statistics
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.
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 facetsTime-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
Do not specify the timeIntervals parameter to 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": {
"allPageViews": {
"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
Specify the timeIntervals parameter to 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": []
}
}