
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
This is how you can find your Organization ID:
- 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
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: Organization Data:- Organization Details - Company profile information
- Daily Follower Statistics - Daily follower gains
- Daily Page Statistics - Daily page views and visitor analytics
- Daily Share Statistics - Daily aggregate engagement metrics
- Lifetime Follower Statistics - Total follower count
- Lifetime Page Statistics - Lifetime page views and analytics
- Lifetime Share Statistics - Lifetime engagement metrics
- 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:Organization Details
Organization Details
Company profile information for your LinkedIn organization.Key Fields:
id- The LinkedIn numeric organization IDurn- URN for the organizationvanityName- The LinkedIn public (vanity) namelocalizedName- The localized name of the organizationlocalizedDescription- Localized description of the organization
organizationType- The organization type (e.g., PRIVATELY_HELD)primaryOrganizationType- Primary type (e.g., BRAND, NONE)staffCountRange- Organization staff count rangefoundedOn- Year the organization was foundedyear- The founding year
name- Structured name data with localized variantsdescription- Structured description with localized variantswebsite- Structured website URLs with localized variantslocalizedWebsite- Localized website URL
specialties- List of specialties for the organizationlocalizedSpecialties- Localized specialtiesalternativeNames- Alternative names for the organization
locations- Array of organization locationslocationType- Type of location (e.g., HEADQUARTERS)address- Address object (city, country, geographicArea)geoLocation- Geo location referencedescription- Location description
logoV2- Organization logo (cropped, original, cropInfo)coverPhotoV2- Cover photo (cropped, original, cropInfo)
defaultLocale- Default locale (country, language)created- Creation metadata (actor, time)lastModified- Last modification metadata (actor, time)versionTag- Version tag of the recordautoCreated- Whether the organization was auto-createdgroups- List of group URNs associated with this organization
Daily Follower Statistics
Daily Follower Statistics
Daily follower statistics for your organization, including follower gains.Key Fields:
date- The date of the report (replication key)organizationalEntity- 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
Lifetime Follower Statistics
Lifetime Follower Statistics
Total follower count for your organization (current snapshot).Key Fields:
date- The date of the reportfirstDegreeSize- Total number of followers (network size)
This stream provides the current total follower count, not historical data. Use Daily Follower Statistics for time-series follower growth data.
Daily Page Statistics
Daily 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 report (replication key)organization- 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
Lifetime Page Statistics
Lifetime Page Statistics
Lifetime page view statistics for your organization’s LinkedIn page. Same structure as Daily Page Statistics but represents cumulative/lifetime data.Key Fields:
date- The date of the report (replication key)organization- The organization URN
totalPageStatistics, all page view breakdowns, and demographic breakdowns), but represents lifetime cumulative data rather than daily increments.Daily Share Statistics
Daily Share Statistics
Lifetime Share Statistics
Lifetime Share Statistics
Posts
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 Posts, providing statistics for each post.Key Fields:
organizationalEntity- The organization URNpostId- The post ID (URN) - links to the Posts streamshare- 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: