L'API LinkedIn : comment y accéder et l’utiliser (guide complet)

Introduction

LinkedIn est un réseau social professionnel en ligne qui permet de connecter des millions de profils de professionnels et d’entreprises entre eux.

LinkedIn met également à disposition des développeurs un ensemble d’API (interfaces de programmation applicative) qui donnent accès à des données structurées et permettent d’intégrer les fonctionnalités de la plateforme dans des applications tierces. Ces API couvrent différents cas d’usage :

• Marketing : suivi des conversions, création et gestion d’événements, publication de contenus, accès aux signaux d’entreprise, etc.
• Ventes et Recrutement : intégration de la messagerie sécurisée, gestion des leads, enrichissement des profils, etc.
• Authentification et données de membres : authentification des utilisateurs (via OAuth 2.0), accès aux données de profil et de connexions, etc.

Dans ce tutoriel, nous allons découvrir comment accéder aux API LinkedIn, en commençant par la création d’une page LinkedIn et d’une application dédiée. À lire également : Linkedin API Guide.

Nous partons du principe que vous possédez déjà un compte LinkedIn, car les étapes suivantes en dépendent. Si ce n’est pas le cas, vous pouvez en créer un ici.

Créer une page LinkedIn

Une page LinkedIn représente la vitrine officielle d’une entreprise, d’un produit, d’un service ou d’une autre entité sur le réseau professionnel LinkedIn. Elle permet de mettre en avant sa marque, de diffuser des informations (actualités, offres d’emploi, etc.) et d’échanger avec sa communauté.

Voici les étapes à suivre pour créer une page LinkedIn :

1. Rendez-vous sur https://www.linkedin.com/company/setup/new/
2. Choisissez le type de page souhaité : Entreprise, Page Vitrine ou Établissement éducatif.
3. Remplissez le formulaire en indiquant le nom de la page, son identifiant public (URL personnalisée), le site web associé, le secteur d’activité, la taille de l’organisation, le type d’organisation, le logo, le slogan, puis confirmez avoir lu et accepté les conditions générales des pages LinkedIn.

Créer une app LinkedIn

Une application LinkedIn constitue le point de connexion officiel entre une application (site web, application mobile, script, etc.) et les API LinkedIn. Sans la création d’une application LinkedIn, l’accès aux API n’est pas possible.

Voici les étapes pour créer une application LinkedIn :

Etape 1 : Rendez-vous au portail développeur LinkedIn, puis cliquez sur Create app. Remplissez ensuite les champs demandés dans le formulaire :

• App name : le nom de votre application
• LinkedIn Page : la page LinkedIn associée à l’application. Si vous n’en avez pas, vous pouvez en créer une en cliquant sur Create a new LinkedIn Page
• App logo : le logo de l’application
• Validation de la lecture et de l’acceptation des conditions d’utilisation de l’API

La capture d’écran ci-dessous montre un exemple de formulaire complété :

Une fois le formulaire correctement complété, cliquez sur Create App pour finaliser la création de l’application LinkedIn.

Etape 2 : Après la création de l’application, vérifiez l’association avec votre page LinkedIn dans l'onglet Settings pour pouvoir demander l'accès à certains API.

Etape 3 : Choisissez les produits ou API souhaités dans l’onglet Products en cliquant sur Request Access, puis acceptez les conditions d’utilisation correspondantes.

Pour certaines API avancées (marketing, données des membres, etc.), une demande d’accès spécifique devra être soumise via un formulaire, qui sera examinée par LinkedIn.

Pour chaque produit, vous pouvez accéder à la documentation via View docs et consulter les points de terminaison de l’API via Endpoints.

Il est important de noter la version du produit indiquée dans Endpoints, car vous l’utiliserez dans votre application, notamment comme valeur du paramètre LATEST_VERSION dans l’exemple que nous allons voir.

Dans l’onglet Auth de votre application LinkedIn, vous avez accès aux éléments suivants :

• Application credentials : les identifiants CLIENT_ID et CLIENT_SECRET de votre application, utilisés pour l’authentification.
• OAuth 2.0 settings : la configuration des URL de redirection autorisées vers votre application, que nous retrouverons dans le paramètre redirect_uri.
• OAuth 2.0 scopes : la liste des permissions (ce que l’application est autorisée à faire), qui seront utilisées dans le paramètre SCOPES.

Utiliser l'API de LinkedIn

Pour exploiter une API LinkedIn, la première étape consiste à s’authentifier afin d’obtenir un token d’accès access_token, puis, dans un second temps, à interroger les endpoints pour effectuer les opérations souhaitées.

Étape 1 : S’authentifier avec OAuth 2.0

LinkedIn met à disposition des clients officiels JavaScript et Python qui facilitent la gestion d’OAuth 2.0 ainsi que les appels aux API. Vous pouvez les retrouver sur la page LinkedIn Developer Platform sur GitHub.

Il est également possible d’utiliser cURL, Axios ou tout autre client HTTP en appelant directement les endpoints décrits dans la documentation officielle.

💡Astuces pour développeurs PHP Laravel : Vous pouvez utiliser le package Laravel Socialite avec le driver linkedin-openid pour s'authentifier.

Le processus d’authentification se déroule comme suit :

1. Redirection de l’utilisateur vers LinkedIn

L’utilisateur est redirigé vers LinkedIn afin de se connecter et d’autoriser l’application :

https://www.linkedin.com/oauth/v2/authorization?response_type=code&client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&scope=SCOPES

Remplacez CLIENT_ID, REDIRECT_URI et SCOPES par les informations correspondant à votre application.

Voici un exemple : https://www.linkedin.com/oauth/v2/authorization?response_type=code&client_id=78abc123xyz456&redirect_uri=https%3A%2F%2Fexemple.com%2Fauth%2Flinkedin%2Fcallback&scope=openid%20profile%20email

Après la connexion et l’acceptation par l’utilisateur, LinkedIn redirige vers votre application pour traiter le code :

REDIRECT_URI?code=AUTHORIZATION_CODE

2. Échange du code contre un access token

Le code d’autorisation obtenu doit ensuite être échangé contre un access token (exemple avec cURL) :

curl -X POST https://www.linkedin.com/oauth/v2/accessToken \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "code=AUTHORIZATION_CODE" \
  -d "redirect_uri=REDIRECT_URI" \
  -d "client_id=CLIENT_ID" \
  -d "client_secret=CLIENT_SECRET"

Remplacer  AUTHORIZATION_CODE par le code obtenu via REDIRECT_URI?code=AUTHORIZATION_CODE, REDIRECT_URI, CLIENT_ID et  CLIENT_SECRET par les informations correspondant à votre application.

Si l'utilisateur est bien authentifié, vous recevez un réponse telle que :

{
  "access_token": "AQX123456789...",
  "expires_in": 5184000
}

Nous disposons maintenant d’un access_token que nous pouvons utiliser pour appeler les API LinkedIn.

Etape 2 : Appeler l'API LinkedIn

Dans les exemples ci-dessous, nous effectuerons des appels à l’API LinkedIn avec cURL, car ces requêtes peuvent être facilement adaptées à n’importe quel client HTTP.

Exemple 1 : Obtenir vos informations de profil de base

curl -X GET 'https://api.linkedin.com/rest/identityMe' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'LinkedIn-Version: LATEST_VERSION'

Remplacez ACCESS_TOKEN par access_token obtenu lors de l'authentification et LATEST_VERSION par la version de l'API (au format YYYYMM) indiqué dans l'onget Products > Endpoints pour chaque produit.

Cette requête fournit une réponse telle que :

{
  "lastRefreshedAt": 1760631246905,
  "id": "1n23dEFSmS",
  "basicInfo": {
    "firstName": {
      "localized": {
        "en_US": "John"
      },
      "preferredLocale": {
        "country": "US",
        "language": "en"
      }
    },
    "lastName": {
      "localized": {
        "en_US": "Doe"
      },
      "preferredLocale": {
        "country": "US",
        "language": "en"
      }
    },
    "primaryEmailAddress": "john.doe@example.com",
    "profileUrl": "https://www.linkedin.com/profile-thirdparty-redirect/example-profile-url",
    "profilePicture": {
      "croppedImage": {
        "downloadUrl": "https://media.licdn.com/dms/image/v2/example/profile-pic",
        "downloadUrlExpiresAt": 1763596800000
      }
    }
  }
}

Exemple 2 : Publier un post sur votre page LinkedIn

curl -X POST 'https://api.linkedin.com/rest/posts' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'X-Restli-Protocol-Version: 2.0.0' \
-H 'Linkedin-Version: LATEST_VERSION' \
-H 'Content-Type: application/json' \
--data '{
  "author": "urn:li:organization:ID_PAGE",
  "commentary": "Exemple de texte pour mon post",
  "visibility": "PUBLIC",
  "distribution": {
    "feedDistribution": "MAIN_FEED",
    "targetEntities": [],
    "thirdPartyDistributionChannels": []
  },
  "lifecycleState": "PUBLISHED",
  "isReshareDisabledByAuthor": false
}'

Remplacez ACCESS_TOKEN, LATEST_VERSION et ID_PAGE par l'identifiant de votre page LinkedIn.

Dans ce tutoriel, nous avons parcouru le processus d’accès et d’utilisation de l’API LinkedIn : de la création de la page LinkedIn, à la mise en place de l’application, puis à l’authentification pour effectuer des appels à l’API.

Portez-vous bien ! 😎