Advanced Analytica Advanced Analytica: IBOM
← All connectors
Linkedin Pages logo

Source connector

Linkedin Pages

Set up Linkedin Pages as a source and move its data into your chosen destination.

Version 1.2.3 community alpha

LinkedIn Pages

Sync overview

The LinkedIn Pages source currently supports Full Refresh only. Incremental Sync is coming soon.

Airbyte uses LinkedIn Marketing Developer Platform - API to fetch data from LinkedIn Pages.

Output schema

You can sync the following data as streams:

Data type mapping

Integration TypeAirbyte TypeNotes
numbernumberfloat number
integerintegerwhole number
arrayarray
booleanbooleanTrue/False
stringstring

Features

FeatureSupported?(Yes/No)Notes
Full Refresh Overwrite SyncYes
Full Refresh Append SyncNo
Incremental - Append SyncYes
Incremental - Append + Deduplication SyncNo
NamespacesNo

Performance

Official rate limits apply to LinkedIn Pages API usage, more information here. Rate-limited requests receive a 429 response.

The limits define the maximum API calls allowed within 24 hours. They reset daily at midnight UTC.

In rare cases, LinkedIn may return a 429 response to protect its infrastructure. API service returns to normal automatically. In these cases, you’ll receive this error message:

"Caught retryable error '<some_error> or null' after <some_number> tries. Waiting <some_number> seconds then retrying..."

This response is expected when the connector receives a 429 - Rate Limit Exceeded HTTP Error. You’ll receive this message after reaching the available API request capacity:

"Max try rate limit exceeded..."

The connector stops the sync after five unsuccessful attempts. Check your Rate Limits at on this page > Choose your app > Analytics.

Getting started

Assign the API user account the required permissions for each API endpoint.

Endpoints including Organization Lookup API, Follower Statistics, Share Statistics, Total Follower Count, Follower Statistics Time Bound and Share Statistics Time Bound require these permissions:

  • r_organization_social: Retrieve your company’s posts, comments, reactions and other engagement data.
  • rw_organization_admin: Manage your company’s pages and retrieve reporting data.

Assign the API user account the ADMIN role.

Authentication

You can authenticate using Access Token or OAuth2.0.

OAuth2.0 is recommended because it streams data for 12 months. An access token streams data for two months.

Create the Refresh_Token or Access_Token

For OAuth2.0 authentication, the LinkedIn Pages source can use client_id, client_secret and refresh_token.

Alternatively, enter an access_token in the connector settings to make API requests. Access tokens expire after 2 months from creation date (60 days) and require you to authenticate again manually.

Refresh tokens expire after 12 months from creation date (365 days). If you receive a 401 invalid token response, the error logs will confirm that your token has expired. Re-authenticate your connection to generate a new token. You can find more details at here.

  1. Log in to LinkedIn as the API user

  2. Create an App here:

    • App Name: airbyte-source
    • Company: Search for and select your LinkedIn Company Page
    • Privacy policy URL: Link to the company privacy policy
    • Business email: Developer or admin email address
    • App logo: Airbyte’s (or Company’s) logo
    • Review and accept the legal terms, then create the app
    • Review the Auth tab:
      • Save your client_id and client_secret (for later steps)
      • Oauth 2.0 settings: Add a redirect_uri (for later steps): https://airbyte.com
  3. Verify App:

    • Open the Settings tab in your app dashboard. Select the Verify button.
    • Generate the verification URL and give it to your Company’s LinkedIn Admin to verify the app.
  4. Request API Access:

    • Open the Products tab
    • Select the Advertising API and accept the legal terms
    • Wait a few minutes, then refresh the page. A View access form link replaces the Select button
    • Complete the access form. Access should be granted within 72 hours, but it’s usually quicker
  5. Create A Refresh Token (or Access Token):

    • Open the LinkedIn Developers’ OAuth Token Tools and select Create token
    • Select your new app and tick the boxes for these scopes:
      • r_organization_social
      • rw_organization_admin
    • Select Request access token. Once generated, save your Refresh token
  6. Use Use the client_id, client_secret and refresh_token from steps 2 and 5 to authorise the LinkedIn Pages connector in the Airbyte UI.

    • Alternatively, use the Access token authentication method for 60-day access.

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Troubleshooting

  • Invalid or expired access token (401): Re-authenticate the source to get a valid LinkedIn access token.
  • Organization access denied (403): Re-authenticate with the scope named in the error. If LinkedIn names no scope, authorise r_organization_social and rw_organization_admin. Ensure the authorised member has the ADMINISTRATOR role for the configured company.
  • Organization not found or inaccessible (404): Check the Organization ID, page status, member’s admin role and app’s API access. The connection check requests one company by ID. It doesn’t list the member’s companies.

Changelog

Expand to review
VersionDatePull RequestSubject
1.2.32026-11-1091631Update dependencies
1.2.22026-11-0378804Update dependencies
1.2.12026-10-3090259Explain missing LinkedIn scopes and organization access failures in connection checks without echoing raw API errors
1.2.02026-10-2689710Retry rate limits and server errors with backoff, report expired tokens, missing permissions and retired API versions clearly, request only whole days for DAY and complete months for MONTH time-bound statistics (each month now arrives 2 days after it ends), add a concurrency option, and migrate legacy configs
1.1.272026-10-2089366Update LinkedIn API version to 202610
1.1.262026-09-1485905Update LinkedIn Marketing API version from 202503 to 202608
1.1.252025-05-2460685Update dependencies
1.1.242025-05-1059786Update dependencies
1.1.232025-05-0358801Update dependencies
1.1.222025-04-1958174Update dependencies
1.1.212025-04-1257721Update dependencies
1.1.202025-04-0556679Update dependencies
1.1.192025-03-2256029Update dependencies
1.1.182025-03-1855816Bump LinkedIn API to 202503
1.1.172025-03-0855441Update dependencies
1.1.162025-03-0154775Update dependencies
1.1.152025-02-2254339Update dependencies
1.1.142025-02-1553859Update dependencies
1.1.132025-02-0853256Update dependencies
1.1.122025-02-0152767Update dependencies
1.1.112025-01-2552246Update dependencies
1.1.102025-01-1851798Update dependencies
1.1.92025-01-1151149Update dependencies
1.1.82024-12-2850645Update dependencies
1.1.72024-12-2150114Update dependencies
1.1.62024-12-1449593Update dependencies
1.1.52024-12-1249272Update dependencies
1.1.42024-12-1148924Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
1.1.32024-10-2947749Update dependencies
1.1.22024-10-2847455Update dependencies
1.1.12024-08-1644196Bump source-declarative-manifest version
1.1.02024-08-1544132Refactor connector to manifest-only format
1.0.172024-08-1043560Update dependencies
1.0.162024-08-0343281Update dependencies
1.0.152024-07-2742782Update dependencies
1.0.142024-07-2042218Update dependencies
1.0.132024-07-1341833Update dependencies
1.0.122024-07-1041407Update dependencies
1.0.112024-07-0941274Update dependencies
1.0.102024-07-0640828Update dependencies
1.0.92024-06-2540422Update dependencies
1.0.82024-06-2239975Update dependencies
1.0.72024-06-1336744Add time bound incremental streams for follower & share statistics. Migrate to Low Code
1.0.62024-06-0639171[autopull] Upgrade base image to v1.2.2
1.0.52024-06-0338918Replace AirbyteLogger with logging.Logger
1.0.42024-06-0338918Replace AirbyteLogger with logging.Logger
1.0.32024-05-2138526[autopull] base image + poetry + up_to_date
1.0.22023-05-3024352Remove duplicate streams
1.0.12023-03-2224352Remove authSpecification as it’s not yet supported
1.0.02023-03-1618967Fixed failing connection checks
0.1.02022-08-1113098Initial Release
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.