Tous les articles

API LinkedIn : publier un post depuis votre code (2026)

API LinkedIn en 2026 : Share on LinkedIn ou Community Management, scopes, validation, Posts API versionnée et upload de médias pour publier un post.

11 min de lecture

API LinkedIn : publier un post depuis votre code (2026)

LinkedIn n’a pas une « API de publication » unique. Il y a un endpoint qui crée les posts, POST https://api.linkedin.com/rest/posts, et plusieurs produits qui déterminent au nom de qui vous avez le droit de les créer. Celui qu’il vous faut dépend d’une seule question : publiez-vous en tant que personne ou en tant que page entreprise ?

Ce guide couvre les deux cas, les scopes, la procédure de validation, les en-têtes de versioning et l’upload en trois étapes des images et des vidéos. Chaque détail sur LinkedIn renvoie à sa documentation sur Microsoft Learn. La dernière section montre le même post envoyé via Bulkit.

Pensé pour les développeurs

Livrez vos intégrations sociales en heures, pas en trimestres

Une seule API REST, des erreurs prévisibles et les particularités de chaque réseau gérées pour vous : publier sur les réseaux sociaux cesse d’être un projet d’un trimestre.

Quelle API LinkedIn utiliser pour publier ?

Deux produits sont à connaître :

Share on LinkedIn Community Management API
Publie en tant que Le membre connecté Le membre, et les pages entreprise qu’il administre
Scope principal w_member_social w_organization_social (plus w_member_social)
Accès En libre-service, depuis l’onglet Products Candidature et validation par LinkedIn
Qui peut candidater Tout développeur Organisations juridiquement enregistrées, usage commercial uniquement

Share on LinkedIn est le produit en libre-service : ajoutez-le dans l’onglet Products du Developer Portal et votre app obtient w_member_social. Cette page présente encore l’ancien endpoint /v2/ugcPosts. La Posts API « remplace l’API ugcPosts », et w_member_social est la permission qu’elle indique pour publier au nom d’un membre. Le nouveau code doit utiliser /rest/posts.

Pour publier au nom d’une page, il vous faut la Community Management API, qui accorde w_organization_social. Ce scope ne fonctionne que sur les pages où le membre connecté a le rôle ADMINISTRATOR, DIRECT_SPONSORED_CONTENT_POSTER ou CONTENT_ADMIN.

Quelles permissions l’API LinkedIn exige-t-elle pour publier ?

D’après le tableau des permissions de la Posts API :

Scope Ce qu’il permet
w_member_social Publier, commenter et liker au nom du membre authentifié
r_member_social Lire les posts du membre. Restreint, utilisateurs approuvés uniquement
w_organization_social Publier, commenter et liker au nom d’une organisation (rôle sur la page requis)
r_organization_social Lire les posts, commentaires et likes d’une organisation (rôle sur la page requis)

Deux pièges reviennent souvent. w_member_social est en écriture seule : vous pouvez créer un post pour un membre, mais pas relire la liste de ses posts sans le scope restreint r_member_social. Et selon la documentation OAuth de LinkedIn, demander un ensemble de scopes différent de celui qu’un membre a déjà accordé invalide tous ses access tokens précédents.

Comment obtenir l’accès à la Community Management API ?

La validation se fait en deux étapes, décrites sur la page Community Management App Review de LinkedIn.

Development tier. Vous remplissez un formulaire de demande d’accès. LinkedIn vérifie le cas d’usage, une adresse e-mail professionnelle vérifiée (les adresses personnelles « ne passeront pas la vérification »), votre organisation et son site web, et qu’un super administrateur de la page LinkedIn de votre entreprise a validé l’app. L’API est « réservée aux organisations juridiquement enregistrées, pour des usages commerciaux uniquement ».

Le Development tier est un bac à sable limité, selon Increasing Access :

  • 500 appels d’API par app sur 24 heures
  • 100 appels d’API par membre sur 24 heures
  • Pas d’appels BATCH_GET
  • Notifications push par webhook désactivées
  • Vous êtes censé terminer votre intégration en 12 mois

Le Standard tier n’a aucune restriction. Pour l’obtenir, vous soumettez un second formulaire, des identifiants de test et un enregistrement d’écran qui parcourt chaque cas d’usage : le flux OAuth complet, un post sur la page, l’affichage des commentaires et les champs de profil des commentateurs que votre app affiche. En cas de refus à l’une ou l’autre étape, vous ne pouvez pas candidater de nouveau avec la même app. Il faut en créer une nouvelle et tout recommencer.

LinkedIn n’annonce aucun délai pour ces validations. Prévoyez de quelques jours à quelques semaines.

Comment fonctionne le versioning de l’API LinkedIn ?

Chaque appel à /rest/ exige deux en-têtes, selon la documentation sur le versioning :

Linkedin-Version: 202610
X-Restli-Protocol-Version: 2.0.0
  • Les versions sont nommées YYYYMM et sortent chaque mois. La plus récente à l’heure où nous écrivons est 202610 (octobre 2026).
  • Chaque version est prise en charge pendant au moins un an, puis retirée.
  • Il n’y a pas de version par défaut. Une requête sans Linkedin-Version renvoie une erreur, tout comme une requête avec une version retirée.
  • En ce moment, chaque page de la Marketing API affiche un avertissement : la version 202511 sera retirée le 16 novembre 2026.

En pratique, gardez la version dans une seule constante et programmez un rappel pour la mettre à jour tous les quelques mois. Une version codée en dur une fois puis oubliée cesse de fonctionner à sa date de retrait.

Comment publier un post texte via l’API LinkedIn ?

Le post organique minimal, tiré de la documentation de la Posts API :

bash
curl -X POST 'https://api.linkedin.com/rest/posts' \
  -H 'Authorization: Bearer {INSERT_TOKEN}' \
  -H 'X-Restli-Protocol-Version: 2.0.0' \
  -H 'Linkedin-Version: 202610' \
  -H 'Content-Type: application/json' \
  --data '{
    "author": "urn:li:organization:5515715",
    "commentary": "Sample text Post",
    "visibility": "PUBLIC",
    "distribution": {
      "feedDistribution": "MAIN_FEED",
      "targetEntities": [],
      "thirdPartyDistributionChannels": []
    },
    "lifecycleState": "PUBLISHED",
    "isReshareDisabledByAuthor": false
  }'
  • author est l’URN d’une personne (urn:li:person:{id}) ou d’une organisation (urn:li:organization:{id}).
  • Un succès renvoie un 201. L’ID du post revient dans l’en-tête de réponse x-restli-id, sous la forme urn:li:share:… ou urn:li:ugcPost:….
  • author, visibility, distribution et lifecycleState sont tous obligatoires. En omettre un renvoie MISSING_FIELD.
  • commentary utilise le format texte « little » de LinkedIn. Les mentions s’écrivent @[Devtestco](urn:li:organization:2414183), et le texte doit correspondre exactement au nom de l’entité (casse comprise), sinon il s’affiche en texte brut.

Les posts organiques prennent en charge le texte, les images, la vidéo, les documents, les articles, le multi-image et les sondages. Les carrousels sont réservés au contenu sponsorisé.

Comment publier une image ou une vidéo sur LinkedIn ?

On ne joint jamais un fichier à la requête de création du post. On l’uploade d’abord, on récupère un URN, puis on place cet URN dans le post.

Images (Images API) :

  1. POST https://api.linkedin.com/rest/images?action=initializeUpload avec {"initializeUploadRequest": {"owner": "urn:li:organization:…"}}.
  2. La réponse contient une uploadUrl, son uploadUrlExpiresAt et l’URN de l’image (urn:li:image:…).
  3. Envoyez les octets à uploadUrl.
  4. Créez le post avec "content": {"media": {"id": "urn:li:image:…", "altText": "…"}}.

Les images doivent être au format JPG, GIF ou PNG, sous 36 152 320 pixels, et les GIF peuvent compter jusqu’à 250 images.

La vidéo (Videos API) passe par un upload en plusieurs parties :

  1. POST /rest/videos?action=initializeUpload avec owner, fileSizeBytes et les drapeaux uploadCaptions / uploadThumbnail.
  2. La réponse contient des uploadInstructions : une entrée par partie, chacune avec firstByte, lastByte et sa propre uploadUrl. Les parties font 4 Mo (octets 0–4194303, puis 4194304–8388607, etc.).
  3. Envoyez chaque partie en PUT à son URL et conservez l’en-tête ETag de chaque réponse.
  4. POST /rest/videos?action=finalizeUpload avec l’URN de la video, l’uploadToken et uploadedPartIds : les ETags, dans le même ordre que les instructions.
  5. Attendez que le status de la vidéo passe à AVAILABLE (elle passe par WAITING_UPLOAD puis PROCESSING ; PROCESSING_FAILED s’accompagne d’une processingFailureReason).
  6. Créez le post avec "content": {"media": {"title": "…", "id": "urn:li:video:…"}}.

La spécification de LinkedIn pour la vidéo dans le fil : MP4, de trois secondes à 30 minutes. Les URL d’upload expirent en général 30 jours après l’initialisation.

Les posts avec lien ne récupèrent pas la page. LinkedIn indique que la Posts API « ne prend pas en charge le scraping d’URL » : vous renseignez vous-même content.article.source, title, description et l’URN d’une image thumbnail. Sans eux, la carte se résume à une URL nue.

Qu’est-ce qui casse en production ?

  • Les tokens durent 60 jours. La documentation OAuth de LinkedIn l’affirme : « tous les access tokens sont émis avec une durée de vie de 60 jours ». Les refresh tokens programmatiques sont « réservés à un ensemble limité de partenaires ». Pour tous les autres, le membre doit repasser par le flux OAuth. Ce flux saute l’écran de consentement s’il est toujours connecté et que l’ancien token n’a pas encore expiré. Construisez le parcours « merci de vous reconnecter » avant le lancement.
  • Les rate limits sont quotidiennes. Share on LinkedIn indique 150 requêtes par membre et 100 000 par application et par jour (UTC). Le Development tier de Community Management est bien plus strict (voir plus haut).
  • Les retraits de version. Voir plus haut : un en-tête, un rappel.
  • Le média n’est pas encore prêt. Publier un URN vidéo avant qu’il soit AVAILABLE échoue. Interrogez l’état de la vidéo, ou relancez le post avec un backoff.
  • Les relances peuvent publier en double. Un timeout sur POST /rest/posts ne vous dit pas si le post a été créé. Vérifiez avant de renvoyer.

Comment publier ou programmer un post LinkedIn avec Bulkit ?

Bulkit ne contourne pas les règles de LinkedIn. Il les applique à votre place. Les deux produits ci-dessus correspondent à deux types de comptes :

  • Profils personnels (linkedin) : ils se connectent directement via l’app LinkedIn de Bulkit, sans app développeur à créer. Vous pouvez aussi utiliser votre propre app avec Share on LinkedIn et Sign In with LinkedIn using OpenID Connect, tous deux approuvés instantanément. Voir le guide de l’app LinkedIn.
  • Pages entreprise (linkedin_page) : votre propre app, nouvelle et distincte, avec la Community Management API. Le guide de l’app LinkedIn Page de Bulkit précise que LinkedIn ne l’accorde qu’à une app sans aucun autre produit, et que rien ne peut être connecté tant que LinkedIn n’a pas approuvé la demande.

La connexion de 60 jours s’applique toujours. À son expiration, le compte affiche Needs reconnect dans Bulkit.

Ensuite, uploads, URN, en-têtes de version et cartes de lien sont gérés pour vous. D’après la page de la plateforme LinkedIn : 3 000 caractères, jusqu’à 20 images, ou une vidéo (de 3 secondes à 30 minutes), ou un PDF publié sous forme de document à faire défiler. Les blocs supplémentaires (jusqu’à 2) sont publiés en commentaires sous le post. Les options se placent dans channels[].options :

Clé Ce qu’elle fait
visibility PUBLIC (par défaut) ou CONNECTIONS. Profils uniquement
document_title Titre affiché sous un PDF
poll_question, poll_options, poll_duration Un sondage (2 à 4 réponses)
article_url, article_title, article_description, article_thumbnail Une carte de lien

Un post peut contenir des fichiers, un sondage ou une carte de lien, mais pas deux de ces éléments à la fois. Voici la carte de lien de la documentation, programmée avec le SDK Node :

ts
import { Bulkit } from "bulkit";

const bulkit = new Bulkit(); // reads BULKIT_API_KEY

const post = await bulkit.posts.create({
  intent: "schedule",
  scheduledAt: "2026-11-01T09:00:00Z",
  channels: [
    {
      channelId: "CHANNEL_LINKEDIN",
      options: {
        article_url: "https://example.com/blog/build-time",
        article_title: "How we cut our build time in half",
      },
      blocks: [{ content: "New on the blog 👇" }],
    },
  ],
});

Comme avec l’API native, LinkedIn ne lit pas la page liée à votre place. Sans article_title, la carte n’affiche que l’adresse, et sans article_thumbnail, elle n’a pas d’image.

Pour une vidéo, uploadez d’abord le fichier et passez son id dans mediaIds. media.uploadMultipart() découpe les gros fichiers et les envoie en parallèle : l’initialisation, les parties, les ETags et la finalisation décrits plus haut sont pris en charge pour vous.

ts
import { openAsBlob } from "node:fs";

const video = await bulkit.media.uploadMultipart(await openAsBlob("launch.mp4"), {
  fileName: "launch.mp4",
  mimeType: "video/mp4",
  concurrency: 4,
});

Les pages entreprise renvoient aussi des statistiques (impressions, likes, commentaires, partages, clics), et vous pouvez lire les commentaires et y répondre au nom de la page. LinkedIn ne permet pas aux apps de lire les commentaires des profils personnels : ce n’est donc pas disponible pour eux. La liste complète des fonctionnalités se trouve sur la page du canal LinkedIn.

API native ou Bulkit ?

Optez pour l’API native si LinkedIn est votre seul réseau, que vous publiez pour une seule page et que gérer le renouvellement des tokens et les montées de version ne vous dérange pas. L’API est bien documentée, et les étapes ci-dessus constituent tout le travail.

Utilisez Bulkit si LinkedIn n’est qu’un réseau parmi d’autres, ou si vous publiez pour de nombreuses personnes et pages. C’est la même requête pour tous les réseaux, et cela coûte 4,99 $ par mois avec 500 actions incluses, puis 0,01 $ par action. Pour l’essayer en TypeScript, la page du SDK Node explique l’installation. Pour laisser un agent IA rédiger et programmer vos posts LinkedIn, connectez-le via MCP.

Pensé pour les développeurs

Livrez vos intégrations sociales en heures, pas en trimestres

Une seule API REST, des erreurs prévisibles et les particularités de chaque réseau gérées pour vous : publier sur les réseaux sociaux cesse d’être un projet d’un trimestre.