
This connector extracts organic data from your LinkedIn Organization Page. For paid advertising data, see the LinkedIn Ads connector.
Configuring LinkedIn as a Source
In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the LinkedIn option from the list of connectors. Click Next and you’ll be prompted to add your access.1. Add account access
You’ll need to authorize Nekt to access your LinkedIn Organization data. Click on the LinkedIn Authorization button and log in with your LinkedIn account. Once you authorize your account, add the following information:- Organization ID: The LinkedIn organization ID you want to extract data from. This is the numeric ID that identifies your company page.
- Start Date: The earliest date from which records will be synced. Note that LinkedIn only returns up to 1 year of historical data for daily reports.
Finding Your Organization ID
Finding Your Organization ID
You can find your Organization ID in several ways:
-
From the Admin View URL:
- Go to your LinkedIn Company Page
- Click on “Admin tools” or access the admin view
- Look at the URL - it will contain something like
/company/12345678/admin/ - The number (e.g.,
12345678) is your Organization ID
-
From the Page Source:
- Visit your company page on LinkedIn
- View the page source (right-click > View Page Source)
- Search for “organizationId” or “companyId”
- The associated number is your Organization ID
-
From LinkedIn Campaign Manager:
- If you have access to Campaign Manager, the Organization ID is visible in the account settings
2. Select streams
Choose which data streams you want to sync. For faster extractions, select only the streams that are relevant to your analysis. You can select entire groups of streams or pick specific ones. Available Streams:- Follower Statistics - Daily follower gains and demographics
- Page Statistics - Page views and visitor analytics
- Share Statistics - Aggregate engagement metrics
- Organization Posts - All posts from your page
- Post Statistics - Individual post performance
Tip: The stream can be found more easily by typing its name.Select the streams and click Next.
3. Configure data streams
Customize how you want your data to appear in your catalog. Select a name for each table (which will contain the fetched data) and the type of sync.- Table name: we suggest a name, but feel free to customize it. You have the option to add a prefix and make this process faster!
-
Sync Type: you can choose between INCREMENTAL and FULL_TABLE.
- Incremental: every time the extraction happens, we’ll get only the new data - which is good if, for example, you want to keep every record ever fetched.
- Full table: every time the extraction happens, we’ll get the current state of the data - which is good if, for example, you don’t want to have deleted data in your catalog.
4. Configure data source
Describe your data source for easy identification within your organization, not exceeding 140 characters. To define your Trigger, consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times). Optionally, you can determine when to execute a full sync. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while. Once you are ready, click Next to finalize the setup.5. Check your new source
You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.Streams and Fields
Below you’ll find all available data streams from LinkedIn and their corresponding fields:Follower Statistics
Follower Statistics
Daily follower statistics for your organization, including follower gains and demographic breakdowns.Key Fields:
date- The date of the reportorganizationalEntity- The organization URN
timeRange- Time range for the statisticsstart- Start timestamp (epoch milliseconds)end- End timestamp (epoch milliseconds)
followerGains- Daily follower changesorganicFollowerGain- New organic followers gainedpaidFollowerGain- New paid followers gained (from ads)
followerCountsByAssociationType- Followers by relationship (employee, etc.)followerCountsByGeoCountry- Followers by countryfollowerCountsByFunction- Followers by job functionfollowerCountsByIndustry- Followers by industryfollowerCountsByGeo- Followers by market area/regionfollowerCountsBySeniority- Followers by seniority levelfollowerCountsByStaffCountRange- Followers by company size
organicFollowerCount- Count of organic followerspaidFollowerCount- Count of paid followers
Page Statistics
Page Statistics
Daily page view and click statistics for your organization’s LinkedIn page, with breakdowns by visitor demographics.Key Fields:
date- The date of the reportorganization- The organization URN
timeRange- Time range for the statisticsstart- Start timestamp (epoch milliseconds)end- End timestamp (epoch milliseconds)
totalPageStatistics- Aggregate statisticsviews- Page view metrics (see below)clicks- Button click countsdesktopCustomButtonClickCounts- Desktop button clicks (buttonId, clicks)mobileCustomButtonClickCounts- Mobile button clicks (buttonId, clicks)
pageViews (total) and uniquePageViews (unique visitors).Aggregate Views:allPageViews- Total page views across all devicesallDesktopPageViews- All desktop page viewsallMobilePageViews- All mobile page views
overviewPageViews- Overview/home tab views (all devices)desktopOverviewPageViews- Desktop overview viewsmobileOverviewPageViews- Mobile overview views
aboutPageViews- About tab views (all devices)desktopAboutPageViews- Desktop about viewsmobileAboutPageViews- Mobile about views
jobsPageViews- Jobs tab views (all devices)desktopJobsPageViews- Desktop jobs viewsmobileJobsPageViews- Mobile jobs views
careersPageViews- Careers tab views (all devices)desktopCareersPageViews- Desktop careers viewsmobileCareersPageViews- Mobile careers viewslifeAtPageViews- Life at [Company] views (all devices)desktopLifeAtPageViews- Desktop life at viewsmobileLifeAtPageViews- Mobile life at views
productsPageViews- Products tab views (all devices)desktopProductsPageViews- Desktop products viewsmobileProductsPageViews- Mobile products views
peoplePageViews- People tab views (all devices)desktopPeoplePageViews- Desktop people viewsmobilePeoplePageViews- Mobile people views
insightsPageViews- Insights tab views (all devices)desktopInsightsPageViews- Desktop insights viewsmobileInsightsPageViews- Mobile insights views
pageStatisticsByGeoCountry- Views by countrypageStatisticsByFunction- Views by job functionpageStatisticsByIndustryV2- Views by industry (v2)pageStatisticsByGeo- Views by region/market areapageStatisticsBySeniority- Views by senioritypageStatisticsByStaffCountRange- Views by company sizepageStatisticsByTargetedContent- Views by targeted content
Share Statistics
Share Statistics
Organization Posts
Organization Posts
All posts published by your organization on LinkedIn.Key Fields:
id- The post ID (URN)author- The author URN (organization)createdAt- Creation timestamp (epoch milliseconds)publishedAt- Publication timestamp (epoch milliseconds)lastModifiedAt- Last modification timestamplifecycleState- Post state (PUBLISHED, DRAFT, etc.)
commentary- The post text/captioncontent- The attached content objectmedia- Image or video mediaid- Media IDtitle- Media titlealtText- Alt text for accessibility
article- Link/article sharetitle- Article titledescription- Article descriptionsource- Source URLthumbnail- Thumbnail image URLthumbnailAltText- Thumbnail alt text
poll- Poll contentquestion- Poll questionoptions- Array of poll options
multiImage- Multiple imagesimages- Array of image objects (url, id, altText)
carousel- Carousel itemsitems- Array of items (url, title)
celebration- Celebration posttype- Celebration typemessage- Celebration message
reference- Reference content (url, title)
contentCallToActionLabel- CTA button labelcontentLandingPage- CTA landing page URL
visibility- Visibility setting (PUBLIC, CONNECTIONS, LOGGED_IN, CONTAINER)distribution- Distribution settingsfeedDistribution- Feed distribution typetargetEntities- Array of targeted audiences (entity, type)thirdPartyDistributionChannels- External distribution channels
adContext- Ad information if post is sponsoredadId- Ad identifiercampaignId- Campaign identifierisDsc- Whether it’s a Direct Sponsored ContentdscStatus- DSC statusdscName- DSC namedscAdType- DSC ad typedscAdAccount- DSC ad account
reshareContext- If this is a reshareparent- Parent post URNroot- Root post URN
isReshareDisabledByAuthor- Whether resharing is disabled
lifecycleStateInfo- Additional state informationcontentStatus- Content moderation statusisEditedByAuthor- Whether edited after publishingreviewStatus- Review status
Post Statistics
Post Statistics
Individual post performance metrics. This stream is a child of Organization Posts, providing statistics for each post.Key Fields:
organizationalEntity- The organization URNshare- The share URN (for legacy shares)ugcPost- The UGC post URN
timeRange- Time range for the statisticsstart- Start timestamp (epoch milliseconds)end- End timestamp (epoch milliseconds)
totalShareStatistics- Post performance metricsclickCount- Number of clicks on the postcommentCount- Number of commentsengagement- Engagement rate (decimal)impressionCount- Total impressionslikeCount- Number of likes/reactionsshareCount- Number of resharesuniqueImpressionsCount- Unique member impressions
Data Model
The following diagram illustrates the relationships between the core data streams in LinkedIn. The arrows indicate the join keys that link the different entities.Use Cases for Data Analysis
This guide outlines valuable business intelligence use cases when consolidating LinkedIn organic data, along with ready-to-use SQL queries that you can run on Explorer.Content Performance Analysis
1. Post Engagement Overview
Track the performance of your LinkedIn posts to identify top-performing content. Business Value:- Identify which content types drive the most engagement
- Understand optimal posting patterns
- Inform content strategy with data-driven insights
SQL query
SQL query
- AWS
- GCP
Sample Result
Sample Result
| post_id | post_preview | published_date | content_type | impressions | unique_impressions | clicks | likes | comments | shares | engagement_rate_pct | total_engagements |
|---|---|---|---|---|---|---|---|---|---|---|---|
| urn:li:share:123456 | We’re excited to announce our new product… | 2024-11-15 14:30:00 | MEDIA | 45,230 | 38,450 | 1,234 | 892 | 156 | 78 | 4.82 | 1,126 |
| urn:li:ugcPost:789012 | Join us for our upcoming webinar on… | 2024-11-12 09:00:00 | ARTICLE | 32,150 | 28,320 | 956 | 543 | 89 | 45 | 3.21 | 677 |
| urn:li:share:345678 | Proud to share that our team has been… | 2024-11-10 16:45:00 | MULTI_IMAGE | 28,900 | 24,670 | 445 | 678 | 234 | 123 | 5.12 | 1,035 |
2. Follower Growth Analysis
Track your organization’s follower growth over time and understand the source of new followers. Business Value:- Monitor organic vs paid follower acquisition
- Track growth trends over time
- Measure the impact of content and campaigns on follower growth
SQL query
SQL query
- AWS
- GCP
Sample Result
Sample Result
| report_date | organic_gained | paid_gained | total_gained | cumulative_growth | seven_day_moving_avg | organic_pct |
|---|---|---|---|---|---|---|
| 2024-11-27 | 45 | 12 | 57 | 1,234 | 48.3 | 78.9 |
| 2024-11-26 | 38 | 8 | 46 | 1,177 | 46.7 | 82.6 |
| 2024-11-25 | 52 | 15 | 67 | 1,131 | 45.1 | 77.6 |
| 2024-11-24 | 28 | 5 | 33 | 1,064 | 43.9 | 84.8 |
| 2024-11-23 | 31 | 7 | 38 | 1,031 | 44.2 | 81.6 |
3. Page Visitor Demographics
Analyze who is visiting your LinkedIn page to understand your audience. Business Value:- Understand your audience composition
- Identify high-value visitor segments
- Inform content targeting decisions
SQL query
SQL query
- AWS
- GCP
Sample Result
Sample Result
| seniority | total_views | unique_views | pct_of_total |
|---|---|---|---|
| urn:li:seniority:5 | 12,450 | 9,230 | 28.4 |
| urn:li:seniority:6 | 9,870 | 7,456 | 22.5 |
| urn:li:seniority:4 | 8,234 | 6,123 | 18.8 |
| urn:li:seniority:3 | 6,543 | 4,890 | 14.9 |
| urn:li:seniority:7 | 4,321 | 3,210 | 9.9 |
Implementation Notes
Data Freshness
Data Freshness
LinkedIn analytics data typically has a delay of 24-48 hours. The most recent data available may be from 1-2 days ago.
- Daily reports: Updated once per day
- Post statistics: Updated as engagement occurs, with some delay
- Lifetime demographics: Represent current state, not historical
Historical Data Limits
Historical Data Limits
LinkedIn limits historical data access:
- Daily statistics (Follower, Page, Share): Up to 1 year of historical data
- Posts: All published posts are available
- Post statistics: Available for all posts, but metrics are cumulative (not daily)
API Permissions
API Permissions
This connector requires the following LinkedIn permissions:
r_organization_social- Read organization posts and social data- Access to Community Management API
URN Format
URN Format
LinkedIn uses URNs (Uniform Resource Names) to identify entities:
- Organizations:
urn:li:organization:{id} - Posts:
urn:li:share:{id}orurn:li:ugcPost:{id} - Seniority levels:
urn:li:seniority:{id} - Industries:
urn:li:industry:{id} - Functions:
urn:li:function:{id} - Countries:
urn:li:geo:{id}orurn:li:country:{code}
Engagement Rate Calculation
Engagement Rate Calculation
LinkedIn’s This is returned as a decimal (e.g., 0.0482 = 4.82%). Multiply by 100 to get the percentage.
engagement field is calculated as: