Skip to content
Book a demo

Connect documentation

All documentation
Documentation

LinkedIn Organizations & Brands: Setup guide

On this page

This guide explains how to collect data from LinkedIn Organizations & Brands.

Introduction

For a list of the fields that you can collect from LinkedIn Organizations & Brands, see LinkedIn Organizations & Brands.

Limitations

Collecting data from LinkedIn Organizations & Brands comes with the following limitations:

  • There are certain limitations for the Time interval filter:

    • When the Daily interval is selected, only data for the current day is returned (the day on which you fetch the data). This means you must include the current day in the date range filters.

    • When the Monthly interval is selected, you must select the date range that is at least a month long.

  • The Country value in the Breakdown filter returns the top 100 countries, with one row per country. This may result in data for smaller countries, outside of the top 100, not being collected. Using other breakdown values may cause a discrepancy in the totals values in the data. For example, the value for the total followers using the country breakdown will be different to the value for the total followers without the country breakdown, if you are collecting data for more than 100 countries.

  • There is a discrepancy when collecting data for organic_followers and paid_followers and using additional breakdown values (such as country or industry). If you select a breakdown, the data is collected for both organic_followers and paid_followers. If you do not select a breakdown, both columns for organic_followers and paid_followers are empty and only the total of both values is returned.

Prerequisites

Before you start collecting data from LinkedIn Organizations & Brands, perform all of the following actions:

  • Ensure the account used to connect to LinkedIn Organizations & Brands has the Super Admin role assigned. For more information on LinkedIn roles’ permissions, see the LinkedIn documentation.

Creating a to collect data from LinkedIn Organizations & Brands

The basics of creating a to collect data from any are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a to fetch data from LinkedIn Organizations & Brands.

Authorization: Allow to access LinkedIn Organizations & Brands

  1. If you choose Access using your credentials or Access using someone else’s credentials, in Set up or edit Organizations, you or the person granting access must choose one of the following options:

    • Choose Grant access to all items, including those created in the future to give Organizations to access all existing items and all items created in the future.

    • Choose Select specific items to which you want to grant access to only give Organizations to access the selected items. will not automatically have access to items created in the future. You will need to grant access to any items created in the future.

Configuration: Choose the data you want to collect from LinkedIn Organizations & Brands

To choose what data to collect and customize the LinkedIn Organizations & Brands configuration, follow these steps:

  1. In Report type, select the type of data to collect from LinkedIn Organizations & Brands. The selected report type determines the additional fields to populate.

  2. In Organizations, select the organizations for which to collect data. If you do not select any items in a drop-down list, collects data for all items in the drop-down list.

  3. (Optional) In Time Interval, select the time interval in which you want to retrieve your data. There are certain limitations on what data can be collected using certain time interval values. See the Limitations section above for more information.

  4. (Optional) In Breakdown, select how to break down the collected data. The list of available breakdown options varies based on the values selected in the other fields in the configuration page.

  5. In Fields, change the list of fields that you want to see in your.

Troubleshooting

No organizations available when setting up an for LinkedIn Organizations & Brands datastream

The No Organizations available message appears during the setup process if the user account does not have the Super Admin role in LinkedIn Organizations & Brands. For more information, see the LinkedIn documentation.

Troubleshooting follower count issues

If you’re seeing empty followerCount values:

  1. Remove the followerCount field from your manual field selection.

  2. Add a demographic breakdown (such as Country, Industry, or Function).

  3. The followerCount will be automatically returned with populated values.

Data validation considerations

When comparing data with the LinkedIn native interface:

  • Account for the 1-day delay in metrics availability.

  • Ensure you’re using the correct date range that accounts for data processing delays.

  • Verify that the same breakdown dimensions are being compared.

Tips and best practices

Understanding follower count configuration

To report total followers, leave out follower fields and select just the Lifetime (interval) and Total (breakdown). Results will include followerCount.

Important: Blank followerCount is a nuance of LinkedIn API. You must select a breakdown such as Country, to get a result.

For Total followers, remove the followerCount field from your request. It will be returned automatically.

Managing data delays

There is a 1 day delay for metrics to be available for page views and follows.

Plan your data collection schedules accordingly, ensuring you account for this delay when fetching recent data.

Authorization requirements

The authorizer must have administrator role to access API.

Ensure that the account used for authorization has:

  • Administrator permissions for the LinkedIn Company Page

  • Appropriate access to view performance metrics

  • Rights to connect third-party applications

Available granularity levels

The connector supports the following levels of granularity:

  • Followers

  • Page

  • Post

  • Comments

  • Share