CompanyUpdateStatistics
Query update statistics about a company. If the TimeRange filters are not specified, the default result set is for the last 12 months.
Note: Requires the r_organization_admin scope.
Select
The cmdlet uses the LinkedIn API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the cmdlet.
- CompanyId supports the '=' comparisons.
- UGCPostId supports the '=,IN' comparisons.
For example, the following queries are processed server side:
SELECT * FROM CompanyUpdateStatistics WHERE CompanyId = '183432' SELECT * FROM CompanyUpdateStatistics WHERE UGCPostId = 'urn:li:ugcPost:1234' SELECT * FROM CompanyUpdateStatistics WHERE UGCPostId IN ('urn:li:ugcPost:1234', 'urn:li:ugcPost:2345')
Time-Based Data Queries
The three inputs that control time-based data queries are TimeGranularity, TimeRangeStart, and TimeRangeEnd. TimeGranularity is not always required, but if it is specified you must also specify TimeRange Start, TimeRangeEnd, or both.The behavior of TimeGranularity in a query depends on what other inputs are specified.
Inputs specified | Result |
None | The driver returns all data from the time the company page was created until the present time, in one record. |
TimeRangeStart only (no TimeRangeEnd or TimeGranularity) | The driver returns all data from the time specified in TimeRangeStart until the present time, in one record. |
TimeRangeStart and TimeRangeEnd (no TimeRangeGranularity) | The driver returns all data from the time specified in TimeRangeStart until the time specified in TimeRangeEnd, in one record. If the value specified in TimeRangeStart is older than the time when the page was created, it retrieves all data from the time the page was created to the time specified in TimeRangeEnd. |
TimeRangeEnd only (no TimeRangeStart or TimeGranularity) | The driver returns all data from the time the company page was created, until the time specified in TimeRangeEnd, in one record. |
All | The driver breaks down the data into multiple records with different time intervals: one record for every day/month beginning from TimeRangeStart until TimeRangeEnd, depending on the value specified in TimeGranularity. |
Columns
Name | Type | Description |
Clicks | Integer | Total clicks count. |
Comments | Integer | Total comments count. |
CommentMentions | Integer | Total comment mentions count. |
Engagement | Double | Total engagement count. |
Impressions | Integer | Total impressions count. |
Likes | Integer | Total likes count. |
Shares | Integer | Total shares count. |
ShareMentions | Integer | Total share mentions count. |
UniqueImpressions | Integer | Total share mentions count. |
TimeRangeStart | Datetime | Exclusive starting datetime of when the query should begin. When not set, queries from the beginning of time. |
TimeRangeEnd | Datetime | Inclusive ending datetime of when the query should end. When not set, queries until the current time. |
TimeGranularity | String | Granularity of the statistics. Must be either DAY or MONTH. Requires TimeRangeStart and TimeRangeEnd. |
UGCPostId | String | The ID of the UGC post. |
ShareId | String | The ID of the share. |
CompanyId | String | Id of the Company associated with the update statistics. |
IntervalStartTime | Datetime | Date start covered by the report data point. For start date of the range covered by the complete report, see the TimeRangeStart column. |
IntervalEndTime | Datetime | Date end covered by the report data point. For the end date of the range covered by the complete report, see the TimeRangeEnd column. |