De LinkedIn comments API: wat je app ermee kan doen
PostCat AI is niet gelieerd aan LinkedIn.
De LinkedIn comments API is de socialActions/comments API. Hiermee kan je app reacties op shares schrijven en lezen. Er zijn methodes om een reactie op te halen, reacties op een share of op een reactie op te halen, en een reactie aan te maken, te bewerken en te verwijderen. Voordat je app gegevens kan ophalen of toegang krijgt tot ledengegevens, moet ze geautoriseerd en geauthenticeerd zijn.
Artem Luko
Founder van PostCat AI
0+
volgers op LinkedIn
Hij heeft zijn eigen LinkedIn-bereik post voor post opgebouwd. PostCat AI is alles wat hij heeft geleerd, op één plek.
Leer hoeWat de LinkedIn comments API je app laat doen
De documentatie van LinkedIn noemt deze methodes:
- Get a Comment
- Batch Get a Collection of Comments
- Get Comments on Shares
- Get Comments on Comments
- Create a Comment
- Edit a Comment
- Delete a Comment
Een enkele reactie lees je met een GET-verzoek naar https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments/{commentId}. Meerdere reacties kan je in één aanroep lezen met .../comments/ids=List({commentId}). De reacties op een share haal je op met een GET-verzoek naar https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments.
Waar je de documentatie vindt
De referentie voor de API staat op Microsoft Learn, want daar publiceert LinkedIn zijn developerdocumentatie. Begin met Microsoft Learn: Comments API. Het LinkedIn Help Center behandelt alleen wat leden op de site en in de app doen, niet de API.
Rechten die je nodig hebt
Elk recht bepaalt wat een app mag doen. De onderstaande tabel houdt de bewoording van de documentatie van LinkedIn aan.
| Recht | Wat het een app laat doen | Toegang |
|---|---|---|
| w_member_social | Laat een app namens een geauthenticeerd lid berichten plaatsen, reageren en berichten liken | Vermeld onder Share on LinkedIn in de tabel met open rechten |
| w_member_social_feed | Laat een app namens het lid reacties en reacties-emoji's op berichten aanmaken, wijzigen en verwijderen | Memberrecht (3-legged) voor de Community Management API |
| r_member_social_feed | Laat een app berichten, reacties en likes ophalen namens een geauthenticeerd lid | Beperkt, alleen aan geselecteerde developers toegekend |
| w_organization_social_feed | Laat een app namens een organisatie berichten plaatsen, reageren en reageren met emoji's | Beperkt tot organisaties waarin het lid een van de rollen van de bedrijfspagina heeft |
De tabellen met rechten zijn niet in elke API-versie gelijk. Controleer de versie die je wilt gebruiken voordat je op een rij vertrouwt.
Velden van een reactie: actor, bericht en antwoorden
Elke reactie heeft een actor, de URN van degene die reageert. Het actorveld is verplicht. Een urn:li:person-actor maakt een persoonlijke reactie, met het lid als uitgever. Een urn:li:organization- of urn:li:organizationBrand-actor maakt een reactie van een organisatie die een lid namens de entiteit heeft geschreven.
Het berichtveld is verplichte tekst en mag links naar personen en organisaties bevatten. Inhoud zoals een afbeelding is optioneel.
Een antwoord is een geneste reactie. Het veld parentComment bevat de URN van de bovenliggende reactie. Dat veld is niet beschikbaar voor reacties op het eerste niveau.
Om een reactie te bewerken gebruikt het verzoek de header X-RestLi-Method: PARTIAL_UPDATE en een patch die de berichttekst instelt. Delete a Comment is een van de genoemde methodes.
Reacties aan- of uitzetten
Reacties op een bericht zet je aan en uit via een andere API, de Social Metadata API. Stel commentsState in op CLOSED om reacties uit te schakelen, en op OPEN om ze in te schakelen. Reacties uitschakelen verwijdert alle bestaande reacties in de thread. Reacties blijven staan. Reacties weer inschakelen laat mensen opnieuw reageren in de thread.
De Social Metadata API accepteert alleen thread-URN's. Elke schrijfactie met een reactie-URN wordt geweigerd. Gebruik voor het aanmaken en ophalen van een reactie de Comments API. De telling is commentSummary.count, die antwoorden meetelt, en commentSummary.topLevelCount, die antwoorden buiten beschouwing laat.
Met de hand reageren op LinkedIn
Als je eerst wilt voelen hoe een reactie werkt voordat je de API aanroept, doe je dat eerst met de hand. De stappen volgen LinkedIn Help: Comment on posts and reply to a comment.
- Klik onder het bericht op Comment, of klik op het tekstvak met Add a comment.
- Typ je reactie.
- Optioneel: klik op het emoji-icoon, het GIF-icoon of het afbeeldingsicoon.
- Klik op Comment.
Om te antwoorden klik je onder een reactie op Reply, of klik je op het tekstvak met Add a reply, typ je je antwoord en klik je op Reply. Leden kunnen het reageren ook beperken tot alleen contacten, zodat mensen die geen 1e-graads contact zijn niet kunnen reageren.
Om je eigen reactie te bewerken klik je op het More-icoon rechts van de reactie, klik je op het Edit-icoon en maak je de wijzigingen, en klik je daarna op Save Changes. De reactie toont dan (edited) erboven. De stappen volgen LinkedIn Help: Edit a comment.
Hoe je begint
Lees de referentie voor de API-versie die je wilt gebruiken, want de rijen met rechten veranderen tussen versies. Begin met één leesaanroep op een bericht dat van jou is. Voeg schrijfacties pas toe als de lezingen geven wat je verwacht.
Wat de helppagina's die we lazen niet zeggen
De helppagina's die we lazen vermelden deze punten niet:
- Limieten en quota voor API-aanroepen.
- Kosten of prijzen voor API-toegang.
- Hoe je een app aanmaakt, hoe je toegang krijgt tot het Marketing Developer Platform of Community Management, hoe lang de goedkeuring duurt, en of individuele developers in aanmerking komen.
- Of een app zonder beheerdersrechten reacties op berichten van andere leden kan lezen.
- Het verzoekformaat voor Delete a Comment, paginering en limieten voor aantallen, en welke API-versie de huidige is.
PostCat AI en reacties
PostCat AI is een onafhankelijk product, niet beheerd of onderschreven door LinkedIn. Het beantwoordt reacties onder de berichten die het publiceert, na goedkeuring of zelfstandig, en werkt alleen via de officiële API van LinkedIn. De prijzen staan op de prijspagina.
Bronnen
- Comments API - LinkedIn (learn.microsoft.com)
- LinkedIn Help: Comment on posts and reply to a comment
- LinkedIn Help: Edit comments in your LinkedIn feed
- Getting Access to LinkedIn APIs - LinkedIn (learn.microsoft.com)
- Increasing Access - LinkedIn (learn.microsoft.com)
- Community Management - Overview - LinkedIn (learn.microsoft.com)
- Migration Guide for Community Management API - LinkedIn (learn.microsoft.com)
- Integration Requirements for Community Management - LinkedIn (learn.microsoft.com)
- Social Metadata API - LinkedIn (learn.microsoft.com)
- Posts API - LinkedIn (learn.microsoft.com)


