Partager via


Community Management - Overview

Warning

Deprecation Notice
The Marketing Version 202310 (Marketing October 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

The Community Management API product allows developers to manage LinkedIn company pages on behalf of their clients and access related account details (e.g., admins & roles, page follower details) and analytics, including comments, reactions, and other activity on page updates.

Approved Use Cases

  • Page Management: Use the Organizations and Brand APIs to create, update, and delete your organization and brand information. Create and manage company posts, comments, and reactions, and monitor engagement from your members. Use the organization access APIs to find the admin roles for a member and all the admins for an organization. Organization lookup APIs are also provided to find organizations, brands, or schools using a vanity name or primary organization type.

  • Page Analytics: Track post analytics and performance of a company page with:

    • Follower statistics APIs: Retrieve both lifetime and time-bound statistics on followers for an organization.
    • Page statistics APIs: Retrieve both lifetime and time-bound statistics on views and clicks for an organization or organization brand page.
    • Share statistics APIs: Retrieve lifetime share statistics and time-bound share statistics and return aggregate share stats within all of the days or months in between the selected date range.
    • Social metadata APIs: Some shares and posts may have social actions such as reactions and comments attached to them. The socialMetadata API allows you to read social actions on these shares or posts, both organic and sponsored. The new service provides access to the reactions content type, which is an expansion of likes and replaces the functionality provided by the existing socialActions endpoint.
    • Video Analytics API: The videoAnalytics API lets you gather analytics about a video entity. The API provides the following metrics:
      • Watch time
      • Video views
      • Video viewers
  • Profile Management: Create and manage posts, comments, and reactions, and monitor engagement, on behalf of individual profiles.

  • Employee Advocacy: Allow brands to leverage their employee networks to reshare and amplify their content via employee profiles. Use the Organization Social Actions Notifications API to notify members about activity on their LinkedIn Company Pages. People Typeahead API is provided that facilitates the discovery of members who can be mentioned in the organization page posts. The API also allows for Pages (via Page Admins) to search for Page followers by keyword or vanity URL.

How Community Management Programs are Organized with Tiers?

The Community Management program includes a Development Tier and a Standard Tier. You will be initially approved with a development tier with limited access to the API call volume. To obtain full access, you will be required to upgrade to the Standard Tier.

When you apply for the Standard Tier, ensure you provide a screen cast video that demonstrates, for each use case specified in your access request form, the same as the use case(s) described in the Standard Tier access request form.

Apply for Access

API product Availability How to Request
Community Management API Vetted Product along with a development and standard tier Use the increasing access link to apply.

Note

Applications must be authorized and authenticated before they can fetch data from LinkedIn or get access to LinkedIn member data. To know more about the OAuth flows, see here.

Postman Collection

Try in Postman

Versioning

LinkedIn’s Marketing API Program supports versioning so API partners can release changes over time. This document explains how to use versioned APIs, see here.

Frequently Asked Questions

1. How do I gain access to the new Community Management API if I already have access to the Advertising API?
Follow the below steps to get provisioned for Community Management API to your current developer application:

  • Create a new developer application with the same company page as the Advertising API.
  • Apply for Community Management API Development Tier access.
  • Upon approval, complete the Standard Tier access request form and submit a screen recording of your developer application to be upgraded to Standard Tier.
  • Once approved, request Community Management API Standard Tier access on your Advertising API developer application. You must enter the developer application client ID of your new developer application in the access form to skip most of the questions.
  • Refer to the detailed migration guide here.

2. What do I do with my newly created developer application if my existing Ads API application now has the Community Management API product?
The newly created developer application was used for verification purposes only and can be discarded.

3. Why is the option to request access to the Community Management API product in developer.linkedin.com/developers grayed out?
You can only request Community Management API Development Tier access with a new developer application that does not have access to any other API product.

4. Can the Community Management API product be added to an existing app?
Yes, please follow the steps from FAQ(1).

5. How do I get access to Member Post Management program?
Member Post Management is an API product to manage member posts and engagement (with r_member_social permission). But this is a high-risk program and not available to developers as a vetted product to apply for.

Stay Informed and Get Support

These resources can help you stay on top of new features, migrations, and deprecations: